getEventLogInformation 函式 (winbase.h)

擷取指定事件記錄檔的相關信息。

語法

BOOL GetEventLogInformation(
  [in]  HANDLE  hEventLog,
  [in]  DWORD   dwInfoLevel,
  [out] LPVOID  lpBuffer,
  [in]  DWORD   cbBufSize,
  [out] LPDWORD pcbBytesNeeded
);

參數

[in] hEventLog

事件記錄檔的句柄。 OpenEventLog 或 RegisterEventSource 函式會傳回這個句柄。

[in] dwInfoLevel

要傳回的事件記錄檔資訊層級。

此參數可以是下列值。

值	意義
EVENTLOG_FULL_INFO	指出指定的記錄檔是否已滿。 lpBuffer 參數將包含EVENTLOG_FULL_INFORMATION結構。

[out] lpBuffer

接收事件記錄檔資訊的應用程式配置緩衝區。 此數據的格式取決於 dwInfoLevel 參數的值。

[in] cbBufSize

lpBuffer 緩衝區的大小，以位元組為單位。

[out] pcbBytesNeeded

函式會將此參數設定為要求資訊所需的緩衝區大小，而不論函式是否成功。 如果函式因 ERROR_INSUFFICIENT_BUFFER 而失敗，請使用此值來配置正確大小的緩衝區。

傳回值

如果函式成功，則傳回非零的值。

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

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll

另請參閱

EVENTLOG_FULL_INFORMATION

事件記錄函式

OpenEventLog

RegisterEventSource