Funzione DispatchMessageW (winuser.h)

Articolo
03/04/2024

Invia un messaggio a una routine di finestra. In genere viene usato per inviare un messaggio recuperato dalla funzione GetMessage .

Sintassi

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

Parametri

[in] lpMsg

Tipo: const MSG*

Puntatore a una struttura contenente 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 in genere viene ignorato.

Commenti

La struttura MSG deve contenere valori di messaggio validi. Se il parametro lpmsg punta a un messaggio 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 selezionare i controlli usando la tastiera, l'applicazione deve chiamare IsDialogMessage. Per altre informazioni, vedere Interfaccia della tastiera della finestra di dialogo.

Esempio

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 di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
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)