SysMsgProc 함수

아티클
07/01/2023

Description

SetWindowsHookExA SetWindowsHookExW함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다./ 시스템은 입력 이벤트가 대화 상자, 메시지 상자, 메뉴 또는 스크롤 막대에서 발생하지만 입력 이벤트에 의해 생성된 메시지가 처리되기 전에 이 함수를 호출합니다. 함수는 시스템의 대화 상자, 메시지 상자, 메뉴 또는 스크롤 막대에 대한 메시지를 모니터링할 수 있습니다.

HOOKPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. SysMsgProc 은 애플리케이션 정의 또는 라이브러리 정의 함수 이름의 자리 표시자입니다.

LRESULT CALLBACK SysMsgProc(
  _In_ int    nCode,
       WPARAM wParam,
  _In_ LPARAM lParam
);

매개 변수

nCode [in]

형식: int

메시지를 생성한 입력 이벤트의 형식입니다.

nCode가 0보다 작은 경우 후크 프로시저는 추가 처리 없이 CallNextHookEx 함수에 메시지를 전달해야 하며 CallNextHookEx에서 반환된 값을 반환해야 합니다.

이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
MSGF_DIALOGBOX 0	입력 이벤트가 메시지 상자 또는 대화 상자에서 발생했습니다.
MSGF_MENU 2	입력 이벤트가 메뉴에서 발생했습니다.
MSGF_SCROLLBAR 5	입력 이벤트가 스크롤 막대에서 발생했습니다.

wParam

형식: WPARAM

이 매개 변수는 사용되지 않습니다.

lParam [in]

형식: LPARAM

MSG 메시지 구조체에 대한 포인터입니다.

반환

형식: LRESULT

nCode가 0보다 작은 경우 후크 프로시저는 CallNextHookEx에서 반환된 값을 반환해야 합니다.

nCode가 0보다 크거나 같고 후크 프로시저가 메시지를 처리하지 않은 경우 CallNextHookEx를 호출하고 반환하는 값을 반환하는 것이 좋습니다. 그렇지 않으면 WH_SYSMSGFILTER 후크를 설치한 다른 애플리케이션은 후크 알림을 받지 못하며 결과적으로 잘못 동작할 수 있습니다.

후크 프로시저가 메시지를 처리한 경우 시스템이 메시지를 대상 창 프로시저에 전달하지 못하도록 0이 아닌 값을 반환할 수 있습니다.