RegisterWindowMessageA-Funktion (winuser.h)

Artikel
03/04/2024

Definiert eine neue Fenstermeldung, die garantiert im gesamten System eindeutig ist. Der Nachrichtenwert kann beim Senden oder Posten von Nachrichten verwendet werden.

Syntax

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Parameter

[in] lpString

Typ: LPCTSTR

Die zu registrierende Nachricht.

Rückgabewert

Typ: UINT

Wenn die Nachricht erfolgreich registriert wurde, ist der Rückgabewert ein Nachrichtenbezeichner im Bereich 0xC000 bis 0xFFFF.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die RegisterWindowMessage-Funktion wird in der Regel verwendet, um Nachrichten für die Kommunikation zwischen zwei kooperierenden Anwendungen zu registrieren.

Wenn zwei verschiedene Anwendungen dieselbe Nachrichtenzeichenfolge registrieren, geben die Anwendungen denselben Nachrichtenwert zurück. Die Nachricht bleibt registriert, bis die Sitzung endet.

Verwenden Sie RegisterWindowMessage nur, wenn mehrere Anwendungen dieselbe Nachricht verarbeiten müssen. Zum Senden privater Nachrichten innerhalb einer Fensterklasse kann eine Anwendung eine beliebige ganze Zahl im Bereich verwenden, der bis 0x7FFF WM_USER . (Nachrichten in diesem Bereich sind für eine Fensterklasse privat, nicht für eine Anwendung. Beispielsweise können vordefinierte Steuerelementklassen wie BUTTON, EDIT, LISTBOX und COMBOBOX Werte in diesem Bereich verwenden.)

Beispiele

Ein Beispiel finden Sie unter Suchen von Text.

Hinweis

Der winuser.h-Header definiert RegisterWindowMessage 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)