Freigeben über


DispatchMessage-Funktion (winuser.h)

Sendet eine Nachricht an eine Fensterprozedur. Es wird in der Regel verwendet, um eine Nachricht zu senden, die von der GetMessage-Funktion abgerufen wird.

Syntax

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

Parameter

[in] lpMsg

Typ: const MSG*

Ein Zeiger auf eine Struktur, die die Nachricht enthält.

Rückgabewert

Typ: LRESULT

Der Rückgabewert gibt den von der Fensterprozedur zurückgegebenen Wert an. Obwohl seine Bedeutung von der gesendeten Nachricht abhängt, wird der Rückgabewert im Allgemeinen ignoriert.

Hinweise

Die MSG-Struktur muss gültige Nachrichtenwerte enthalten. Wenn der lpmsg-Parameter auf eine WM_TIMER Nachricht verweist und der lParam-Parameter der WM_TIMER Nachricht nicht NULL ist, verweist lParam auf eine Funktion, die anstelle der Fensterprozedur aufgerufen wird.

Beachten Sie, dass die Anwendung für das Abrufen und Senden von Eingabenachrichten an das Dialogfeld verantwortlich ist. Die meisten Anwendungen verwenden hierfür die Standard-Nachrichtenschleife. Damit der Benutzer jedoch über die Tastatur zu Steuerelementen wechseln und diese auswählen kann, muss die Anwendung IsDialogMessage aufrufen. Weitere Informationen finden Sie unter Dialogfeld-Tastaturschnittstelle.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Nachrichtenschleife.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

GetMessage

IsDialogMessage

MSG

Nachrichten und Nachrichtenwarteschlangen

PeekMessage

Referenz

TranslateMessage

WM_TIMER