FwpsCalloutUnregisterById0 函数 (fwpsk.h)
FwpsCalloutUnregisterById0 函数从筛选器引擎中注销标注。
注意FwpsCalloutUnregisterById0 是 FwpsCalloutUnregisterById 的特定版本。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本 。
语法
NTSTATUS FwpsCalloutUnregisterById0(
[in] const UINT32 calloutId
);
参数
[in] calloutId
从筛选器引擎中注销的标注的运行时标识符。 这必须是标注驱动程序调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数以向筛选器引擎注册标注时返回的运行时标识符。
返回值
FwpsCalloutUnregisterById0 函数返回以下 NTSTATUS 代码之一。
| 返回代码 | 说明 |
|---|---|
|
标注已成功从筛选器引擎中注销。 |
|
标注正在处理一个或多个数据流，这些数据流具有与数据流关联的未完成上下文。 标注驱动程序必须为其中每个数据流调用 FwpsFlowRemoveContext0 函数，以删除关联的上下文。 从每个数据流成功删除上下文后，标注驱动程序必须再次调用 FwpsCalloutUnregisterById0 函数，以完成从筛选器引擎中注销标注的操作。 |
|
没有与 calloutId 参数中指定的运行时标识符匹配的筛选器引擎注册的标注。 |
|
标注已在另一个线程中注册或注销。 |
|
出现了错误。 |
注解
标注驱动程序调用 FwpsCalloutUnregisterById0 函数以从筛选器引擎取消注册标注，并使用运行时标识符标识要注销的标注。 即使筛选器引擎中有筛选器指定筛选器操作的标注，此函数也会成功。 在这种情况下，操作类型为 FWP_ACTION_CALLOUT_TERMINATING 或 FWP_ACTION_CALLOUT_UNKNOWN 的筛选器被视为 FWP_ACTION_BLOCK，操作类型为 FWP_ACTION_CALLOUT_INSPECTION 的筛选器在从筛选器引擎中注销标注后将被忽略。
在以前注册到筛选器引擎的所有标注都已成功注销之前，无法卸载标注驱动程序。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows Vista 开始可用。 |
| 目标平台 | 通用 |
| 标头 | fwpsk.h (包括 Fwpsk.h) |
| Library | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |