FwpsCalloutUnregisterByKey0 函式 (fwpsk.h)
FwpsCalloutUnregisterByKey0 函式會從篩選引擎取消註冊圖說文字。
注意FwpsCalloutUnregisterByKey0 是特定版本的 FwpsCalloutUnregisterByKey。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定 Windows 版本為目標 。
語法
NTSTATUS FwpsCalloutUnregisterByKey0(
[in] const GUID *calloutKey
);
參數
[in] calloutKey
GUID 的指標，可唯一識別從篩選引擎取消註冊的圖說文字。 這必須是呼叫 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函式以向篩選引擎註冊圖說文字時所指定的相同 GUID 指標。
傳回值
FwpsCalloutUnregisterByKey0 函式會傳回下列其中一個 NTSTATUS 代碼。
| 傳回碼 | Description |
|---|---|
|
圖說文字已成功從篩選引擎取消註冊。 |
|
圖說文字有一或多個數據流正在處理，這些數據流具有與數據流相關聯的未處理內容。 圖說文字驅動程式必須針對每個數據流呼叫 FwpsFlowRemoveContext0 函式，才能移除相關聯的內容。 從這些數據流成功移除內容之後，圖說文字驅動程式必須再次呼叫 FwpsCalloutUnregisterByKey0 函式，才能從篩選引擎取消註冊圖說文字。 |
|
沒有向篩選引擎註冊的圖說文字符合 calloutKey 參數中指定的 GUID。 |
|
圖說文字已經在另一個線程中註冊或取消註冊。 |
|
發生錯誤。 |
備註
圖說文字驅動程式會呼叫 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 |