FwpmCalloutDeleteByKey0 函数 (fwpmk.h)

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

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

语法

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

[in] engineHandle

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

[in] key

指向 GUID 的指针，该 GUID 唯一标识要从筛选器引擎中删除的标注。这必须是指向在标注驱动程序调用 FwpmCalloutAdd0 函数以将标注添加到筛选器引擎时指定的相同 GUID 的指针。

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

返回代码	说明
STATUS_SUCCESS	标注已成功从筛选器引擎中删除。
STATUS_FWP_IN_USE	筛选器引擎中的一个或多个筛选器指定筛选器操作的标注。
STATUS_FWP_CALLOUT_NOT_FOUND	筛选器引擎中没有与 key 参数中指定的 GUID 匹配的标注。
其他状态代码	出现了错误。

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

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

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