FwpmCalloutDeleteById0 函数 (fwpmk.h)

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

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

语法

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 参数中指定的运行时标识符匹配的标注。
其他状态代码	出现了错误。

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

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

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