DispatchMessageW-Funktion (winuser.h)

Artikel
03/06/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 DispatchMessageW(
  [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 wert an, der von der Fensterprozedur zurückgegeben wird. 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 zeigt und der lParam-Parameter der WM_TIMER Meldung 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 Tastaturschnittstelle für Dialogfelder.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Nachrichtenschleife.

Hinweis

Der winuser.h-Header definiert DispatchMessage als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)