DebugProc 함수

아티클
07/01/2023

SetWindowsHookExA SetWindowsHookExW함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다./ 시스템은 모든 후크 유형과 연결된 후크 프로시저를 호출하기 전에 이 함수를 호출합니다. 시스템은 디버그프로크 후크 프로시저에 호출할 후크에 대한 정보를 전달하여 정보를 검사하고 후크를 호출할 수 있는지 여부를 결정합니다.

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

구문

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

매개 변수

nCode [in]
형식: int

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

wParam [in]
형식: WPARAM

호출할 후크의 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
WH_CALLWNDPROC 4	창 프로시저로 전송된 메시지를 모니터링하는 후크 프로시저를 설치합니다. 자세한 내용은 [CallWndProc](callwndproc.md) 후크 프로시저에 대한 설명을 참조하세요.
WH_CALLWNDPROCRET 12	창 프로시저에서 방금 처리된 메시지를 모니터링하는 후크 프로시저를 설치합니다. 자세한 내용은 CallWndRetProc 후크 프로시저에 대한 설명을 참조하세요.
WH_CBT 5	CBT 애플리케이션에 유용한 알림을 수신하는 후크 프로시저를 설치합니다. 자세한 내용은 [CBTProc](cbtproc.md) 후크 프로시저에 대한 설명을 참조하세요.
WH_DEBUG 9	다른 후크 프로시저를 디버깅하는 데 유용한 후크 프로시저를 설치합니다. 자세한 내용은 DebugProc 후크 프로시저에 대한 설명을 참조하세요.
WH_GETMESSAGE 3	메시지 큐에 게시된 메시지를 모니터링하는 후크 프로시저를 설치합니다. 자세한 내용은GetMsgProc 후크 프로시저에 대한 설명을 참조하세요.
WH_JOURNALPLAYBACK 1	WH_JOURNALRECORD 후크 프로시저에서 이전에 기록한 메시지를 게시하는 후크 프로시저를 설치합니다. 자세한 내용은 JournalPlaybackProc 후크 프로시저에 대한 설명을 참조하세요.
WH_JOURNALRECORD 0	시스템 메시지 큐에 게시된 입력 메시지를 기록하는 후크 프로시저를 설치합니다. 이 후크는 매크로를 기록하는 데 유용합니다. 자세한 내용은 JournalRecordProc 후크 프로시저에 대한 설명을 참조하세요.
WH_KEYBOARD 2	키 입력 메시지를 모니터링하는 후크 프로시저를 설치합니다. 자세한 내용은 KeyboardProc 후크 프로시저에 대한 설명을 참조하세요.
WH_MOUSE 7	마우스 메시지를 모니터링하는 후크 프로시저를 설치합니다. 자세한 내용은 [MouseProc](mouseproc.md) 후크 프로시저에 대한 설명을 참조하세요.
WH_MSGFILTER -1	대화 상자, 메시지 상자, 메뉴 또는 스크롤 막대에서 입력 이벤트의 결과로 생성된 메시지를 모니터링하는 후크 프로시저를 설치합니다. 후크 프로시저는 후크 프로시저를 설치한 애플리케이션에 대해서만 이러한 메시지를 모니터링합니다. 자세한 내용은 [MessageProc](messageproc.md) 후크 프로시저를 참조하세요.
WH_SHELL 10	Shell 애플리케이션에 유용한 알림을 수신하는 후크 프로시저를 설치합니다. 자세한 내용은 [ShellProc](shellproc.md) 후크 프로시저 및 WH_SHELL 후크 섹션에 대한 설명을 참조하세요.
WH_SYSMSGFILTER 6	대화 상자, 메시지 상자, 메뉴 또는 스크롤 막대에서 입력 이벤트의 결과로 생성된 메시지를 모니터링하는 후크 프로시저를 설치합니다. 후크 프로시저는 시스템의 모든 애플리케이션에 대해 이러한 메시지를 모니터링합니다. 자세한 내용은 [SysMsgProc](sysmsgproc.md) 후크 프로시저에 대한 설명을 참조하세요.

lParam [in]
형식: LPARAM

대상 후크 프로시저에 전달할 매개 변수를 포함하는 DEBUGHOOKINFO 구조체에 대한 포인터입니다.

반환 값

형식:****

형식: LRESULT

시스템이 후크를 호출하지 못하도록 하려면 후크 프로시저가 0이 아닌 값을 반환해야 합니다. 그렇지 않으면 후크 프로시저가 CallNextHookEx를 호출해야 합니다.

설명

애플리케이션은 SetWindowsHookExA/SetWindowsHookExW 함수에 대한 호출에서 후크 프로시저에 대한 포인터와 WH_DEBUG 후크 형식을 지정하여 이 후크 프로시저를 설치합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Winuser.h(Windows.h 포함)