FwpsCalloutUnregisterByKey0 函式 (fwpsk.h)

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

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

語法

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

參數

[in] calloutKey

GUID 的指標,可唯一識別從篩選引擎取消註冊的圖說文字。 這必須是呼叫 FwpsCalloutRegister0FwpsCalloutRegister1 函式時所指定的相同 GUID 指標,才能向篩選引擎註冊圖說文字。

傳回值

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

傳回碼 描述
STATUS_SUCCESS
圖說文字已成功從篩選引擎取消註冊。
STATUS_DEVICE_BUSY
圖說文字處理了一或多個資料流程,這些資料流程具有與資料流程相關聯的未完成內容。 圖說文字驅動程式必須為每個資料流程呼叫 FwpsFlowRemoveCoNtext0 函式,才能移除相關聯的內容。 從每個資料流程成功移除內容之後,圖說文字驅動程式必須再次呼叫 FwpsCalloutUnregisterByKey0 函式,才能完成從篩選引擎取消註冊圖說文字。
STATUS_FWP_CALLOUT_NOT_FOUND
沒有向篩選引擎註冊的圖說文字元合 calloutKey 參數中指定的 GUID。
STATUS_FWP_IN_USE
圖說文字已經在另一個執行緒中註冊或取消註冊。
其他狀態碼
發生錯誤。

備註

圖說文字驅動程式會呼叫 FwpsCalloutUnregisterByKey0 函式,以從篩選引擎取消註冊圖說文字,並使用 GUID 金鑰識別要取消註冊的圖說文字。 即使篩選引擎中有篩選準則指定篩選動作的圖說文字,此函式仍會成功。 在此情況下,動作類型為 FWP_ACTION_CALLOUT_TERMINATINGFWP_ACTION_CALLOUT_UNKNOWN 的篩選會被視為 FWP_ACTION_BLOCK,而動作類型為 FWP_ACTION_CALLOUT_INSPECTION 的篩選準則會在從篩選引擎取消註冊之後忽略。

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

必要條件

   
最低支援的用戶端 從 Windows Vista 開始提供。
目標平臺 環球
標頭 fwpsk.h (包括 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另請參閱

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveCoNtext0

圖說文字的類型