FwpsCalloutUnregisterById0 函式 (fwpsk.h)

FwpsCalloutUnregisterById0 函式會從篩選引擎取消註冊圖說文字。

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

 

語法

NTSTATUS FwpsCalloutUnregisterById0(
  [in] const UINT32 calloutId
);

參數

[in] calloutId

要從篩選引擎取消註冊之圖說文字的運行時間標識碼。 這必須是呼叫 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函式時所傳回的運行時間標識碼，才能向篩選引擎註冊圖說文字。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	圖說文字已成功從篩選引擎取消註冊。
STATUS_DEVICE_BUSY	圖說文字處理了一或多個數據流，這些數據流具有與數據流相關聯的未完成內容。 圖說文字驅動程式必須為每個數據流呼叫 FwpsFlowRemoveContext0 函式，才能移除相關聯的內容。 從每個數據流成功移除內容之後，圖說文字驅動程式必須再次呼叫 FwpsCalloutUnregisterById0 函式，才能完成從篩選引擎取消註冊圖說文字。
STATUS_FWP_CALLOUT_NOT_FOUND	沒有向篩選引擎註冊的圖說文字，其符合 calloutId 參數中指定的運行時間識別碼。
STATUS_FWP_IN_USE	圖說文字已經在另一個線程中註冊或取消註冊。
其他狀態代碼	發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsCalloutUnregisterById0 函式，以從篩選引擎取消註冊圖說文字，並使用運行時間標識符來識別要取消註冊的圖說文字。 即使篩選引擎中有篩選條件指定篩選動作的圖說文字，此函式仍會成功。 在此情況下，動作類型為 FWP_ACTION_CALLOUT_TERMINATING 或 FWP_ACTION_CALLOUT_UNKNOWN 的篩選會被視為 FWP_ACTION_BLOCK，而動作類型為 FWP_ACTION_CALLOUT_INSPECTION 的篩選條件會在從篩選引擎取消註冊之後忽略。

除非先前向篩選引擎註冊的所有圖說文字已成功取消註冊，否則無法卸除圖說文字驅動程式。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL

另請參閱

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

圖說文字的類型