FwpmCalloutDeleteById0 函式 (fwpmk.h)

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

注意FwpmCalloutDeleteById0 是特定版本的 FwpmCalloutDeleteById。如需詳細資訊，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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

[in] engineHandle

篩選引擎開啟會話的句柄。圖說文字驅動程式會呼叫 FwpmEngineOpen0 函式，以開啟篩選引擎的會話。

[in] id

要從篩選引擎中刪除之圖說文字的運行時間標識碼。這必須是呼叫 FwpmCalloutAdd0 函式之圖說驅動程式時所傳回的運行時間標識符，才能將圖說文字新增至篩選引擎。

FwpmCalloutDeleteById0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	已成功從篩選引擎中刪除圖說文字。
STATUS_FWP_IN_USE	篩選引擎中的一或多個篩選會指定篩選動作的圖說文字。
STATUS_FWP_CALLOUT_NOT_FOUND	篩選引擎中沒有符合 id 參數中指定的運行時間識別碼的圖說文字。
其他狀態代碼	發生錯誤。

圖說文字驅動程式會呼叫 FwpmCalloutDeleteById0 函式，以使用運行時間標識符來識別要刪除的圖說文字。

圖說文字驅動程式通常不會從篩選引擎中刪除其圖說文字。在大部分情況下，這會由使用者模式 Windows 篩選平臺管理應用程式處理。

只有在篩選引擎中沒有指定篩選動作的圖說文字時，才能從篩選引擎中刪除圖說文字。