EvtOpenSession 函式 (winevt.h)
建立與遠端電腦的連線，您可以在呼叫其他 Windows 事件記錄檔函式時使用。
語法
EVT_HANDLE EvtOpenSession(
[in] EVT_LOGIN_CLASS LoginClass,
[in] PVOID Login,
[in] DWORD Timeout,
[in] DWORD Flags
);
參數
[in] LoginClass
用來連線到遠端電腦的連線方法。 如需可能的值，請參閱 EVT_LOGIN_CLASS 列舉。
[in] Login
EVT_RPC_LOGIN結構，識別您要連線的遠端計算機、使用者的認證，以及連線時要使用的驗證類型。
[in] Timeout
保留的。 必須為零。
[in] Flags
保留的。 必須為零。
傳回值
如果成功，函式會傳回會話句柄，您可以用來存取遠端電腦上的事件記錄檔資訊;否則為 NULL。 如果 為 NULL，請呼叫 GetLastError 函 式以取得錯誤碼。
備註
當您完成會話句柄時，請呼叫 EvtClose 函式。 關閉會話句柄也會關閉會話中建立的所有開啟句柄， (關閉開啟句柄會取消這些句柄上任何目前的活動) 。
若要連線到遠端計算機，遠端計算機必須啟用「遠端事件記錄檔管理」Windows 防火牆例外狀況;否則，當您嘗試使用會話句柄時，呼叫將會發生錯誤並出現RPC_S_SERVER_UNAVAILABLE。 您要連線的電腦必須執行 Windows Vista 或更新版本。
此函式不會驗證認證;第一次嘗試使用會話句柄時，就會驗證認證。 如果認證無效，呼叫將會因為ERROR_ACCESS_DENIED而失敗。
範例
如需示範如何使用此函式的範例，請參閱 存取遠端計算機。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winevt.h |
| 程式庫 | Wevtapi.lib |
| Dll | Wevtapi.dll |