FwpmCalloutDeleteByKey0 函数（fwpmk.h）

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

语法

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

[in] engineHandle

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

[in] key

指向唯一标识从筛选器引擎中删除的标注的 GUID 的指针。这必须是指向调用 FwpmCalloutAdd0 函数时指定的同一 GUID 的指针，才能将标注添加到筛选器引擎。

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

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

标注驱动程序调用 FwpmCalloutDeleteByKey0 函数以从筛选器引擎中删除标注，并使用 GUID 键标识要删除的标注。

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

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

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