Funzione callback ForegroundIdleProc

Articolo
07/01/2023

Funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione SetWindowsHookExA/SetWindowsHookExW . Il sistema chiama questa funzione ogni volta che il thread in primo piano sta per diventare inattiva.

Sintassi

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

Parametri

codice [in]
Tipo: int

Se il codice è HC_ACTION, la procedura di hook deve elaborare il messaggio. Se il codice è minore di zero, la procedura di hook deve passare il messaggio alla funzione CallNextHookEx senza ulteriore elaborazione e restituire il valore restituito da CallNextHookEx.
wParam
Tipo: DWORD

Questo parametro non viene usato.
lParam
Tipo: LONG

Questo parametro non viene usato.

Valore restituito

Digitare:****

Tipo: DWORD

Se il codice è minore di zero, la procedura di hook deve restituire il valore restituito da CallNextHookEx.

Se il codice è maggiore o uguale a zero, è consigliabile chiamare CallNextHookEx e restituire il valore restituito; in caso contrario, altre applicazioni installate WH_FOREGROUNDIDLE hook non riceveranno notifiche di hook e potrebbero comportarsi in modo errato come risultato. Se la procedura di hook non chiama CallNextHookEx, il valore restituito deve essere zero.

Commenti

Il tipo HOOKPROC definisce un puntatore a questa funzione di callback. ForegroundIdleProc è un segnaposto per il nome di funzione definito dall'applicazione o dalla libreria.

Un'applicazione installa questa procedura di hook specificando il tipo di hook WH_FOREGROUNDIDLE e il puntatore alla procedura di hook in una chiamata alla funzione SetWindowsHookExA/SetWindowsHookExW .

Durante l'elaborazione di questa funzione di callback, evitare di chiamare tutte le funzioni che recuperano i messaggi della finestra dalla coda dei messaggi del thread chiamante. Ciò include funzioni GetMessage, PeekMessageA/PeekMessageW, finestra di dialogo modale e FUNZIONI COM. La chiamata di tali funzioni può comportare la mancata restituzione del thread da GetMessage o WaitMessage quando sono presenti messaggi nella coda dei messaggi del thread chiamante.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

CallNextHookEx

SetWindowsHookExA/SetWindowsHookExW

Informazioni concettuali

Hook

Condividi tramite