Funzione DispatchMessageW (winuser.h)

Articolo
11/20/2024

Invia un messaggio a una routine finestra. Viene in genere usato per inviare un messaggio recuperato dalla funzione GetMessage .

Sintassi

LRESULT DispatchMessageW(
  [in] const MSG *lpMsg
);

Parametri

[in] lpMsg

Tipo: MSG*

Puntatore a una struttura che contiene il messaggio.

Valore restituito

Tipo: LRESULT

Il valore restituito specifica il valore restituito dalla routine della finestra. Anche se il suo significato dipende dal messaggio inviato, il valore restituito viene in genere ignorato.

Osservazioni

La struttura MSG deve contenere valori di messaggio validi. Se il parametro lpmsg punta a un messaggio di WM_TIMER e il parametro lParam del messaggio di WM_TIMER non è null, lParam punta a una funzione chiamata anziché alla routine della finestra.

Si noti che l'applicazione è responsabile del recupero e dell'invio di messaggi di input alla finestra di dialogo. La maggior parte delle applicazioni usa il ciclo di messaggi principale per questo. Tuttavia, per consentire all'utente di passare a e di selezionare i controlli tramite la tastiera, l'applicazione deve chiamare IsDialogMessage. Per altre informazioni, vedere finestra di dialogo Interfaccia della tastiera.

Esempi

Per un esempio, vedere Creazione di un ciclo di messaggi.

Nota

L'intestazione winuser.h definisce DispatchMessage come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-message-l1-1-0 (introdotto in Windows 8)