DispatchMessageA-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 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 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) |
Siehe auch
Konzept
Nachrichten und Nachrichtenwarteschlangen
Referenz