DispatchMessage-Funktion (winuser.h)

Artikel
03/04/2024

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)