FwpmCalloutAdd0 函式 （fwpmk.h）

  • 發行項

FwpmCalloutAdd0 函式會將圖說文字新增至篩選引擎。

語法

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

參數

[in] engineHandle

篩選引擎開啟會話的句柄。 圖說文字驅動程式會呼叫 FwpmEngineOpen0 函式，以開啟篩選引擎的會話。

[in] callout

常數 FWPM_CALLOUT0 結構的指標，其中包含將圖說文字新增至篩選引擎所需的數據。

[in, optional] sd

常數 SECURITY_DESCRIPTOR 結構的指標，描述要加入至篩選引擎之圖說文字的安全性描述項。 這個參數是選擇性的，而且可以 NULL。

[out, optional] id

UINT32 型別變數的指標，可接收識別篩選引擎中註標的運行時間標識碼。 這個標識元與圖說文字驅動程式向篩選引擎註冊圖說文字驅動程式的圖說文字函式時所傳回的標識符相同。 圖說文字驅動程式會在從篩選引擎移除圖說文字時，將此標識碼傳遞至 FwpmCalloutDeleteById0 函式。 這個參數是選擇性的，而且可以 NULL。

傳回值

FwpmCalloutAdd0 函式會傳回下列其中一個 NTSTATUS 程式代碼：

傳回碼 描述
STATUS_SUCCESS 圖說文字已成功新增至篩選引擎。
STATUS_FWP_ALREADY_EXISTS 圖說文字無法新增至篩選引擎。 圖說文字已存在於篩選引擎中，標識元與 圖說文字參數所 指向之 FWPM_CALLOUT0 結構 成員的 GUID 相同。
其他 NTSTATUS 代碼 發生錯誤。

言論

圖說文字驅動程式會呼叫 FwpmCalloutAdd0 函式，將圖說文字新增至篩選引擎。

圖說文字驅動程式通常不會將其圖說文字新增至篩選引擎。 在大部分情況下，這會由使用者模式 Windows 篩選平臺管理應用程式處理。

在圖說文字驅動程式向篩選引擎註冊圖說文字之前，可以將指定篩選動作圖說文字的圖說文字新增至篩選引擎。 在此情況下，會將動作類型的 FWP_ACTION_CALLOUT_TERMINATING 或 FWP_ACTION_CALLOUT_UNKNOWN 篩選視為 FWP_ACTION_BLOCK，並忽略具有 FWP_ACTION_CALLOUT_INSPECTION 動作類型的篩選，直到圖說文字向篩選引擎註冊為止。

FwpmCalloutAdd0 是 FwpmCalloutAdd 的特定版本。 如需詳細資訊，請參閱 糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

要求

要求 價值
最低支援的用戶端 從 Windows Vista 開始提供。
目標平臺 普遍
標頭 fwpmk.h （包括 Fwpmk.h）
連結庫 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另請參閱