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
반환할 이벤트 로그 정보의 수준입니다.
이 매개 변수는 다음 값일 수 있습니다.
| 값 | 의미 |
|---|---|
|
지정된 로그가 가득 찼는지 여부를 나타냅니다. lpBuffer 매개 변수에는 EVENTLOG_FULL_INFORMATION 구조체가 포함됩니다. |
[out] lpBuffer
이벤트 로그 정보를 수신하는 애플리케이션 할당 버퍼입니다. 이 데이터의 형식은 dwInfoLevel 매개 변수의 값에 따라 달라집니다.
[in] cbBufSize
lpBuffer 버퍼의 크기(바이트)입니다.
[out] pcbBytesNeeded
함수는 함수의 성공 여부에 관계없이 이 매개 변수를 요청된 정보에 필요한 버퍼 크기로 설정합니다. 함수가 올바른 크기의 버퍼를 할당하기 위해 ERROR_INSUFFICIENT_BUFFER 실패하는 경우 이 값을 사용합니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |