UnhookWinEvent 함수(winuser.h)

SetWinEventHook에 대한 이전 호출에서 만든 이벤트 후크 함수를 제거합니다.

구문

BOOL UnhookWinEvent(
  [in] HWINEVENTHOOK hWinEventHook
);

매개 변수

[in] hWinEventHook

형식: HWINEVENTHOOK

SetWinEventHook에 대한 이전 호출에서 반환된 이벤트 후크에 대한 핸들입니다.

반환 값

형식: BOOL

성공하면 TRUE를 반환합니다 . 그렇지 않으면 FALSE를 반환합니다.

세 가지 일반적인 오류로 인해 이 함수가 실패합니다.

• hWinEventHook 매개 변수가 NULL이거나 유효하지 않습니다.
• hWinEventHook에 지정된 이벤트 후크가 이미 제거되었습니다.
• UnhookWinEvent 는 SetWinEventHook에 대한 원래 호출과 다른 스레드에서 호출됩니다.

설명

이 함수는 해당 콜백 함수가 추가 이벤트 알림을 받지 못하도록 hWinEventHook 에 지정된 이벤트 후크를 제거합니다. 클라이언트의 스레드가 종료되면 시스템에서 이 함수를 자동으로 호출합니다.

이벤트 후크를 설치한 동일한 스레드에서 이 함수를 호출합니다. SetWinEventHook에 해당하는 호출과 다른 스레드에서 호출되면 UnhookWinEvent가 실패합니다.

이 이벤트 후크를 설치할 때 WINEVENT_INCONTEXT 지정한 경우 시스템은 해당 DLL을 로드한 모든 프로세스에서 해당 DLL을 언로드하려고 시도합니다. 언로드가 즉시 발생하지는 않지만 UnhookWinEvent 가 반환된 후에는 후크 함수가 호출되지 않습니다. WINEVENT_INCONTEXT 대한 자세한 내용은 컨텍스트 내 후크 함수를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
재배포 가능 파일	SP6 이상 및 Windows 95를 Windows NT 4.0의 활성 접근성 1.3 RDK