---
title: "IsBanned | open.mp"
description: "检查指定IP地址是否被封禁"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsBanned
language: zh-CN
---

# IsBanned

注意

这个函数是在omp v1.1.0.2612中添加的，在以前的版本中不起作用！

## 描述

检查指定 IP 地址是否存在于封禁列表中。

| 参数 | 说明 |
| --- | --- |
| const ipAddress\[\] | 需要检查的 IP 地址 |

## 返回值

**true** - IP 地址已被封禁  
**false** - IP 地址未被封禁

## 示例

```c
if (IsBanned("255.255.255.255"))
{
    // 执行相关操作
}
```

## 注意事项

技巧

封禁列表可通过查看 **bans.json** 文件获取

## 相关函数

-   [BlockIpAddress](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/BlockIpAddress): 禁止指定 IP 地址在设定时间内连接服务器
-   [UnBlockIpAddress](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/UnBlockIpAddress): 解除已封禁的 IP 地址
-   [Ban](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/Ban): 封禁指定玩家
-   [BanEx](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/BanEx): 使用自定义原因封禁玩家
-   [Kick](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/Kick): 踢出指定玩家
-   [ClearBanList](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/ClearBanList): 清空封禁列表