FwpmCalloutDeleteByKey0 函式（fwpmk.h）

FwpmCalloutDeleteByKey0 函式會從篩選引擎刪除圖說文字。

語法

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

[in] engineHandle

篩選引擎開啟會話的句柄。「註標」驅動程式會呼叫 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 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。