FwpmCalloutAdd0 函式 (fwpmk.h)

發行項
02/26/2024

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

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

語法

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 代碼：

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

備註

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

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

在圖說文字驅動程式向篩選引擎註冊圖說文字之前，可以加入篩選動作的圖說文字和篩選條件。在此情況下，動作類型 為FWP_ACTION_CALLOUT_TERMINATING 或 FWP_ACTION_CALLOUT_UNKNOWN的 篩選會被視為 FWP_ACTION_BLOCK ，而且會忽略動作類型 為 FWP_ACTION_CALLOUT_INSPECTION 的篩選條件，直到圖說文字向篩選引擎註冊為止。

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平台	Universal
標頭	fwpmk.h (包含 Fwpmk.h)
程式庫	Fwpkclnt.lib
IRQL	PASSIVE_LEVEL