OpenEventLogA 函式（winbase.h）

開啟指定事件記錄檔的句柄。

語法

HANDLE OpenEventLogA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

[in] lpUNCServerName

要開啟事件記錄檔之遠端伺服器的通用命名約定（UNC）名稱。如果此參數 NULL，則會使用本機計算機。

[in] lpSourceName

記錄檔的名稱。

如果您指定自定義記錄檔且找不到，事件記錄服務會開啟應用程式記錄 ;不過，將不會有相關聯的訊息或類別字串檔案。

如果函式成功，傳回值就是事件記錄檔的句柄。

如果函式失敗，則傳回值 NULL。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

若要關閉事件記錄檔的句柄，請使用 closeEventLog 函式。

如需範例，請參閱查詢事件資訊。

注意

winbase.h 標頭會將 OpenEventLog 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll
API 集	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 （在 Windows 10 版本 10.0.10240 中引進）