FwpsCalloutUnregisterByKey0 函式 (fwpsk.h)

  • 發行項

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

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

語法

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

參數

[in] calloutKey

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

傳回值

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

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

備註

圖說文字驅動程式會呼叫 FwpsCalloutUnregisterByKey0 函式，以從篩選引擎取消註冊圖說文字，並使用 GUID 密鑰來識別要取消註冊的圖說文字。 即使篩選引擎中有篩選條件指定篩選動作的圖說文字，此函式仍會成功。 在此情況下，動作類型 為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

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

圖說文字的類型