FwpmFilterDeleteByKey0 函数 （fwpmk.h）
FwpmFilterDeleteByKey0 函数从系统中删除筛选器对象。
语法
NTSTATUS FwpmFilterDeleteByKey0(
[in] HANDLE engineHandle,
[in] const GUID *key
);
参数
[in] engineHandle
筛选引擎打开的会话句柄。 调用 FwpmEngineOpen0 以打开筛选器引擎的会话。
[in] key
要从系统中删除的对象的唯一标识符。 这是当应用程序为此对象调用 FwpmFilterAdd0 时指定的相同 GUID。
返回值
| 返回代码/值 | 描述 |
|---|---|
|
ERROR_SUCCESS 0 |
已成功删除筛选器。 |
|
FWP_E_* 错误代码 0x80320001 — 0x80320039 |
Windows 筛选平台（WFP）特定错误。 有关详细信息，请参阅 WFP 错误代码。 |
|
RPC_* 错误代码 0x80010001 — 0x80010122 |
无法与远程或本地防火墙引擎通信。 |
| 其他 NTSTATUS 代码 | 发生错误。 |
言论
不能从只读事务中调用此函数，它失败并 FWP_E_INCOMPATIBLE_TXN。 有关事务的详细信息，请参阅 对象管理。
如果在同一会话中添加了相应的对象，则可以在动态会话中调用此函数。 如果为在不同动态会话期间添加的对象调用此函数，它将失败并 FWP_E_WRONG_SESSION。 如果为动态会话期间未添加的对象调用此函数，它将失败并 FWP_E_DYNAMIC_SESSION_IN_PROGRESS。
调用方需要 DELETE 对筛选器的访问权限。 有关详细信息，请参阅 访问控制。
FwpmFilterDeleteById0 是 FwpmFilterDeleteById 的特定实现。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows Vista 开始可用。 |
| 目标平台 | 普遍 |
| 标头 | fwpmk.h |
| 库 | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |