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