---
title: mmpm_remove_rule
description: "多模规则匹配引擎删除目标规则。rule->key和rule->key_len需要一一对应，否则无法确保功能符合预期。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengddk/boostida/kdadkmmpm/kunpeng_datadistribution_01_0016.html
sourcePath: /source/zh/kunpengddk/boostida/kdadkmmpm/kunpeng_datadistribution_01_0016.html
indexId: 998ded4079cb255b03994082583b59b41261aa17c739229de39e345b1306cb4378
---
# mmpm_remove_rule

#### 接口功能

多模规则匹配引擎删除目标规则。rule->key和rule->key_len需要一一对应，否则无法确保功能符合预期。


#### 接口定义

```
int mmpm_remove_rule(mmpm_handler_t *handler, mmpm_rule_t *rule, uint32_t rule_num);
```


#### 参数说明

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| handler | 匹配引擎句柄 | 非NULL | 输入 |
| rule | 待删除的规则数组 | 非NULL | 输入 |
| rule\_num | 删除规则数量 | 非负值，取值范围与uint32\_t保持一致 值必须与参数rule的实际数组长度一致；否则会出现访问越界异常 | 输入 |


#### 返回值

- 成功：返回0。
- 失败：返回错误码。


#### 约束

仅支持匹配引擎为“MMPM_MATCHER_TYPE_HASH”。