영어로 읽기

다음을 통해 공유


DebugProc 함수

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 포함)

    추가 정보

    CallNextHookEx

    CallWndProc

    CallWndRetProc

    CBTProc

    DEBUGHOOKINFO

    GetMsgProc

    JournalPlaybackProc

    JournalRecordProc

    KeyboardProc

    MessageProc

    MouseProc

    SetWindowsHookExA/SetWindowsHookExW

    ShellProc

    SysMsgProc

    후크