FwpmCalloutDeleteById0 函数（fwpmk.h）

FwpmCalloutDeleteById0 函数从筛选器引擎中删除标注。

语法

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

[in] engineHandle

对筛选器引擎打开的会话的句柄。标注驱动程序调用 FwpmEngineOpen0 函数以打开对筛选器引擎的会话。

[in] id

要从筛选器引擎中删除的标注的运行时标识符。这必须是调用 FwpmCalloutAdd0 函数的标注驱动程序时返回的运行时标识符，才能将标注添加到筛选器引擎。

FwpmCalloutDeleteById0 函数返回以下 NTSTATUS 代码之一。

返回代码	描述
STATUS_SUCCESS	标注已成功从筛选器引擎中删除。
STATUS_FWP_IN_USE	筛选器引擎中的一个或多个筛选器指定筛选器操作的标注。
STATUS_FWP_CALLOUT_NOT_FOUND	筛选器引擎中没有与 ID 参数中指定的运行时标识符匹配的标注。
其他 NTSTATUS 代码	发生错误。

标注驱动程序调用 FwpmCalloutDeleteById0 函数以从筛选器引擎中删除标注，并使用运行时标识符标识要删除的标注。

标注驱动程序通常不会从筛选器引擎中删除其标注。在大多数情况下，用户模式 Windows 筛选平台管理应用程序进行处理。

仅当筛选器引擎中没有为筛选器操作指定标注的筛选器引擎时，才能从筛选器引擎中删除标注。

FwpmCalloutDeleteById0 是 FwpmCalloutDeleteById的特定版本。有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。