共用方式為

FwpmEngineOpen0 函式 （fwpmk.h）

  • 發行項

FwpmEngineOpen0 函式會開啟篩選引擎的會話。

語法

NTSTATUS FwpmEngineOpen0(
  [in, optional] const wchar_t             *serverName,
  [in]           UINT32                    authnService,
  [in, optional] SEC_WINNT_AUTH_IDENTITY_W *authIdentity,
  [in, optional] const FWPM_SESSION0       *session,
  [out]          HANDLE                    *engineHandle
);

參數

[in, optional] serverName

NULL 終止字串的指標，指定開啟篩選引擎會話之系統的標準 DNS 名稱。 圖說文字驅動程式必須指定此參數 NULL。

[in] authnService

要使用的驗證服務。 如需此參數的有效選項清單，請參閱 Microsoft Windows SDK 檔中的 RPC 一節中的 Authentication-Service 常數。 註標驅動程式必須指定此參數的RPC_C_AUTHN_WINNT或RPC_C_AUTHN_DEFAULT。

[in, optional] authIdentity

SEC_WINNT_AUTH_IDENTITY_W 結構的指標，其中包含存取篩選引擎的驗證和授權認證。 從註標驅動程式呼叫 FwpmEngineOpen0 函式時，會忽略此參數。 註標驅動程式應將此參數設定為 NULL。

[in, optional] session

FWPM_SESSION0 結構的指標，定義所開啟之會話的會話特定參數。 此指標是選擇性的，而且可以 NULL。

[out] engineHandle

變數的指標，這個變數會接收篩選引擎開啟會話的句柄。

傳回值

FwpmEngineOpen0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 描述
STATUS_SUCCESS 已成功開啟篩選引擎的會話。 engineHandle 參數所指向的變數包含開啟會話的句柄。
其他 NTSTATUS 代碼 發生錯誤。

言論

圖說文字驅動程式會呼叫 FwpmEngineOpen0 函式，以開啟篩選引擎的會話。 篩選引擎開啟會話的句柄，是大部分 Windows 篩選平臺管理功能的必要參數。

圖說驅動程式通常不需要開啟篩選引擎的會話，因為圖說文字驅動程式通常不會呼叫任何 Windows 篩選平臺 管理功能。

若要讓圖說驅動程式成功開啟篩選引擎的會話，篩選引擎必須在圖說驅動程式呼叫 FwpmEngineOpen0 函式時執行。 圖說文字驅動程式可以呼叫 FwpmBfeStateGet0 函式，以取得篩選引擎的目前狀態。 呼叫 FwpmBfeStateGet0之前，圖說驅動程式必須呼叫 FwpmBfeStateSubscribeChanges0 函式，以註冊每當篩選引擎狀態發生變更時，就會呼叫的回呼函式。

在圖說驅動程式完成存取篩選引擎之後，它會呼叫 FwpmEngineClose0 函式，以關閉篩選引擎的開啟會話。

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

要求

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

另請參閱