DispatchMessageA-Funktion (winuser.h)

Artikel
20.11.2024

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

Syntax

C++

LRESULT DispatchMessageA(
  [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 ihre Bedeutung von der Nachricht abhängt, die verteilt wird, wird der Rückgabewert im Allgemeinen ignoriert.

Bemerkungen

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 Verteilen von Eingabemeldungen an das Dialogfeld verantwortlich ist. Die meisten Anwendungen verwenden dafür die Hauptnachrichtenschleife. Damit der Benutzer jedoch mithilfe der 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.

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-message-l1-1-0 (eingeführt in Windows 8)