NotifyChangeEventLog 함수(winbase.h)
지정된 이벤트 로그에 이벤트가 기록될 때 애플리케이션이 알림을 받을 수 있도록 합니다. 이벤트가 로그에 기록되면 지정된 이벤트 개체가 신호 상태로 설정됩니다.
구문
BOOL NotifyChangeEventLog(
[in] HANDLE hEventLog,
[in] HANDLE hEvent
);
매개 변수
[in] hEventLog
이벤트 로그에 대한 핸들입니다. OpenEventLog 함수는 이 핸들을 반환합니다.
[in] hEvent
수동 재설정 또는 자동 재설정 이벤트 개체에 대한 핸들입니다. CreateEvent 함수를 사용하여 이벤트 개체를 만듭니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
NotifyChangeEventLog 함수는 원격 핸들에서 작동하지 않습니다. hEventLog 매개 변수가 원격 컴퓨터의 이벤트 로그에 대한 핸들인 경우 NotifyChangeEventLog는 0을 반환하고 GetLastError는 ERROR_INVALID_HANDLE 반환합니다.
시스템이 PulseEvent를 호출할 때 스레드가 이벤트를 대기하지 않는 경우 스레드는 알림을 받지 못합니다. 따라서 알림을 기다리는 별도의 스레드를 만들어야 합니다.
시스템은 이벤트 로그에 대한 핸들을 닫을 때까지 변경 내용을 계속 알립니다. 이벤트 로그를 닫려면 CloseEventLog 또는 DeregisterEventSource 함수를 사용합니다.
예제
예제는 이벤트 알림 수신을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winbase.h(Windows.h 포함) |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |
| API 세트 | ext-ms-win-advapi32-eventlog-l1-1-1(Windows 10 버전 10.0.10240에 도입됨) |