Funzione SysMsgProc

Articolo
07/01/2023

Descrizione

Funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione SetWindowsHookExA/SetWindowsHookExW . Il sistema chiama questa funzione dopo che si verifica un evento di input in una finestra di dialogo, una finestra di messaggio, un menu o una barra di scorrimento, ma prima che il messaggio generato dall'evento di input venga elaborato. La funzione può monitorare i messaggi per qualsiasi finestra di dialogo, finestra di messaggio, menu o barra di scorrimento nel sistema.

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

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

Parametri

nCode [in]

Tipo: int

Tipo di evento di input che ha generato il messaggio.

Se nCode è minore di zero, la procedura di hook deve passare il messaggio alla funzione CallNextHookEx senza ulteriore elaborazione e deve restituire il valore restituito da CallNextHookEx.

Questo parametro può avere uno dei valori seguenti.

Valore	Significato
MSGF_DIALOGBOX 0	L'evento di input si è verificato in una finestra di dialogo o in una finestra di dialogo.
MSGF_MENU 2	L'evento di input si è verificato in un menu.
MSGF_SCROLLBAR 5	L'evento di input si è verificato in una barra di scorrimento.

wParam

Tipo: WPARAM

Questo parametro non viene usato.

lParam [in]

Tipo: LPARAM

Puntatore a una struttura di messaggi MSG .

Restituisce

Tipo: LRESULT

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

Se nCode è maggiore o uguale a zero e la procedura di hook non ha elaborato il messaggio, è consigliabile chiamare CallNextHookEx e restituire il valore restituito; in caso contrario, altre applicazioni installate WH_SYSMSGFILTER hook non riceveranno notifiche di hook e potrebbero comportarsi in modo errato come risultato.

Se la procedura di hook ha elaborato il messaggio, può restituire un valore diverso da zero per impedire al sistema di passare il messaggio alla procedura della finestra di destinazione.

Commenti

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