FwpmEngineOpen0 函式 (fwpmu.h)
FwpmEngineOpen0函式會開啟篩選引擎的會話。
語法
DWORD 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
類型： const wchar_t*
此值必須是 Null。
[in] authnService
類型： UINT32
指定要使用的驗證服務。 允許的服務RPC_C_AUTHN_WINNT和RPC_C_AUTHN_DEFAULT。
[in, optional] authIdentity
類型： SEC_WINNT_AUTH_IDENTITY_A*
用於存取篩選引擎的驗證和授權認證。 此指標是選擇性的，可以是 Null。 如果這個指標為 Null，則會使用呼叫執行緒的認證。
[in, optional] session
類型： FWPM_SESSION0*
正在開啟之會話的會話特定參數。 此指標是選擇性的，可以是 Null。
[out] engineHandle
類型： HANDLE*
篩選引擎開啟會話的控制碼。
傳回值
類型： DWORD
| 傳回碼/值 | 描述 |
|---|---|
|
會話已成功啟動。 |
|
已開啟具有指定 sessionKey 的會話 。 |
|
Windows 篩選平台 () 特定錯誤。 如需詳細資訊，請參閱 其錯誤碼 。 |
|
無法與遠端或本機防火牆引擎通訊。 |
備註
使用者應用程式必須呼叫 FwpmEngineOpen0 ，才能取得篩選引擎開啟會話的控制碼，才能新增或移除任何篩選物件。 大部分其他 Windows 篩選平台管理功能也需要篩選引擎開啟會話的控制碼。
會話會在程式結束時自動關閉。 若要明確關閉會話，請呼叫 FwpmEngineClose0。
如果 會話。旗標 會設定為 FWPM_SESSION_FLAG_DYNAMIC，會話結束時，會自動刪除會話期間新增的任何一個其任何一個的一個。」 如果會話不是動態的，則呼叫端必須明確刪除會話期間新增的所有一個的一切的一般物件。
呼叫端需要 FWPM_ACTRL_OPEN 篩選引擎的存取權。 如需詳細資訊，請參閱存取控制。
FwpmEngineOpen0 僅適用于非模擬模式。
FwpmEngineOpen0 是 FwpmEngineOpen 的特定實作。 如需詳細資訊 ，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標 。
範例
下列 C++ 範例會使用 FwpmEngineOpen0 開啟篩選會話。
// Open a session to the filter engine
HANDLE engineHandle = NULL;
DWORD result = ERROR_SUCCESS;
printf("Opening the filter engine.\n");
result = FwpmEngineOpen0(
NULL,
RPC_C_AUTHN_WINNT,
NULL,
NULL,
&engineHandle );
if (result != ERROR_SUCCESS)
printf("FwpmEngineOpen0 failed. Return value: %d.\n", result);
else
printf("Filter engine opened successfully.\n");
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | fwpmu.h |
| 程式庫 | Fwpuclnt.lib |
| Dll | Fwpuclnt.dll |