(winbase.h) OpenEventLogA 函式

開啟指定事件記錄檔的控制碼。

語法

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 [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll
API 集合 ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (Windows 10 10.0.10240 版)

另請參閱

ClearEventLog

CloseEventLog

事件記錄函式

Eventlog 索引鍵

ReadEventLog

ReportEvent