Condividi tramite


Funzione DispatchMessage (winuser.h)

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

Sintassi

LRESULT DispatchMessage(
  [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.

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)

Vedi anche

Informazioni concettuali

GetMessage

IsDialogMessage

MSG

Messaggi e code di messaggi

PeekMessage

Riferimento

TranslateMessage

WM_TIMER