RegisterWindowMessageW-Funktion (winuser.h)

Artikel
08/27/2023

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

Syntax

UINT RegisterWindowMessageW(
  [in] LPCWSTR 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 Funktion RegisterWindowMessage wird in der Regel verwendet, um Nachrichten für die Kommunikation zwischen zwei kooperierenden Anwendungen zu registrieren.

Wenn zwei unterschiedliche 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 privat für eine Fensterklasse, 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 nach Text.

Hinweis

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

Anforderungen


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 (in Windows 8 eingeführt)