共用方式為


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

傳回碼/值 描述
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

另請參閱

Authentication-Service 常數

FWPM_SESSION0

FwpmEngineClose0

Kernel-Mode FwpmEngineOpen0

SEC_WINNT_AUTH_IDENTITY_A