다음을 통해 공유


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에 도입됨)

추가 정보

SetWinEventHook

UnhookWinEvent