EvtOpenLog 函式 (winevt.h)

取得通道或記錄檔的控制碼，您接著可用來取得通道或記錄檔的相關資訊。

語法

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

[in] Session

EvtOpenSession 函式傳回的遠端會話控制碼。設定為 Null ，以開啟本機電腦上的通道或登入。

[in] Path

已匯出記錄檔的通道名稱或完整路徑。

[in] Flags

旗標，判斷 Path 參數是否指向記錄檔或通道。如需可能的值，請參閱 EVT_OPEN_LOG_FLAGS 列舉。

如果成功，函式會傳回檔案或通道的控制碼;否則為 Null。如果 為 Null，請呼叫 GetLastError 函式以取得錯誤碼。

指定檔案時，無法使用相對路徑和環境變數。通用命名慣例 (UNC) 路徑可用來尋找檔案。進行 API 呼叫之前，必須先完成任何相對路徑和環境變數擴充。

若要取得通道或記錄檔的相關資訊，請呼叫 EvtGetLogInfo 函式。