Condividi tramite


Funzione callback ForegroundIdleProc

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