IsWinEventHookInstalled 함수(winuser.h)
지정된 이벤트에 대한 알림을 받을 수 있는 설치된 WinEvent 후크가 있는지 여부를 확인합니다.
구문
BOOL IsWinEventHookInstalled(
[in] DWORD event
);
매개 변수
[in] event
형식: DWORD
후크가 알림을 받을 수 있는 이벤트 상수입니다. 함수는 이 이벤트 상수에 대해 설치된 후크가 있는지 확인합니다.
반환 값
형식: BOOL
지정된 이벤트에 대한 알림을 받을 후크가 있는 경우 반환 값은 TRUE입니다.
지정된 이벤트에 대한 알림을 받을 후크가 없으면 반환 값은 FALSE입니다.
설명
이 메서드는 가음성 을 반환하지 않도록 보장됩니다. 이 메서드가 FALSE를 반환하는 경우 시스템의 후크가 이벤트에 대한 알림을 받지 않음을 의미합니다. 그러나 이 메서드는 가양성 을 반환할 수 있습니다. 즉, 알림을 받을 후크가 없더라도 TRUE 를 반환할 수 있습니다. 따라서 이 메서드가 FALSE를 반환하는 경우 구성 요소가 일부 작업을 우회하는 것이 안전합니다.
이벤트 후크는 언제든지 설치할 수 있으므로 서버 개발자는 장시간 반환 값을 캐시해서는 안 됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| 재배포 가능 파일 | Sp6 이상 및 Windows 98을 사용하여 Windows NT 4.0의 활성 접근성 2.0 RDK |
| API 세트 | ext-ms-win-ntuser-server-l1-1-1(Windows 10 버전 10.0.14393에 도입됨) |