FwpmCalloutDeleteById0 函式 (fwpmk.h)
FwpmCalloutDeleteById0 函式會從篩選引擎中刪除圖說文字。
語法
NTSTATUS FwpmCalloutDeleteById0(
[in] HANDLE engineHandle,
[in] UINT32 id
);
參數
[in] engineHandle
篩選引擎開啟會話的句柄。 圖說驅動程式會呼叫 FwpmEngineOpen0 函式,以開啟篩選引擎的會話。
[in] id
要從篩選引擎中刪除之圖說文字的運行時間標識碼。 這必須是呼叫 FwpmCalloutAdd0 函式時所傳回的運行時間標識符,才能將圖說文字新增至篩選引擎。
傳回值
FwpmCalloutDeleteById0 函式會傳回下列其中一個 NTSTATUS 代碼。
傳回碼 | 描述 |
---|---|
STATUS_SUCCESS | 已成功從篩選引擎中刪除圖說文字。 |
STATUS_FWP_IN_USE | 篩選引擎中的一或多個篩選會指定篩選動作的註標。 |
STATUS_FWP_CALLOUT_NOT_FOUND | 篩選引擎中沒有符合 標識子 參數中指定的運行時間標識符的圖說文字。 |
其他 NTSTATUS 代碼 | 發生錯誤。 |
言論
圖說文字驅動程式會呼叫 FwpmCalloutDeleteById0 函式,以使用運行時間標識符來識別要刪除的圖說文字。
圖說文字驅動程式通常不會從篩選引擎中刪除其圖說文字。 在大部分情況下,這會由使用者模式 Windows 篩選平臺 管理應用程式來處理。
只有在篩選引擎中沒有指定篩選動作圖說文字的篩選條件時,才能從篩選引擎中刪除圖說文字。
FwpmCalloutDeleteById0 是 FwpmCalloutDeleteById 的特定版本。 如需詳細資訊,請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows Vista 開始提供。 |
目標平臺 | 普遍 |
標頭 | fwpmk.h (包括 Fwpmk.h) |
連結庫 | Fwpkclnt.lib |
IRQL | PASSIVE_LEVEL |