FwpmEngineOpen0 函式 (fwpmu.h)

發行項
08/23/2023

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

傳回碼/值	描述
ERROR_SUCCESS 0	會話已成功啟動。
FWP_E_ALREADY_EXISTS 0x80320009	已開啟具有指定 sessionKey 的會話。
*FWP_E_ 錯誤碼** 0x80320001— 0x80320039	Windows 篩選平台 () 特定錯誤。如需詳細資訊，請參閱其錯誤碼。
*RPC_ 錯誤碼** 0x80010001— 0x80010122	無法與遠端或本機防火牆引擎通訊。

備註

使用者應用程式必須呼叫 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