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 |