ForegroundIdleProc 콜백 함수

아티클
07/01/2023

SetWindowsHookExA SetWindowsHookExW함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다./ 포그라운드 스레드가 유휴 상태가 될 때마다 시스템에서 이 함수를 호출합니다.

구문

DWORD CALLBACK ForegroundIdleProc(
  _In_ int   code,
       DWORD wParam,
       LONG  lParam
);

매개 변수

코드 [in]
형식: int

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

이 매개 변수는 사용되지 않습니다.
lParam
형식: LONG

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

반환 값

형식:****

형식: DWORD

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

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

설명

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

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

이 콜백 함수를 처리하는 동안 호출 스레드의 메시지 큐에서 창 메시지를 검색하는 함수를 호출하지 마세요. 여기에는 GetMessage, PeekMessageA/PeekMessageW, 모달 대화 상자 및 COM 함수가 포함됩니다. 이러한 함수를 호출하면 호출 스레드의 메시지 큐에 메시지가 있는 경우 스레드가 GetMessage 또는 WaitMessage 에서 반환되지 않을 수 있습니다.

요구 사항

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