RegisterClassExW-Funktion (winuser.h)

Artikel
07/21/2023

Registriert eine Fensterklasse zur späteren Verwendung in Aufrufen der Funktion CreateWindow oder CreateWindowEx .

Syntax

ATOM RegisterClassExW(
  [in] const WNDCLASSEXW *unnamedParam1
);

Parameter

[in] unnamedParam1

Typ: const WNDCLASSEX*

Ein Zeiger auf eine WNDCLASSEX-Struktur . Sie müssen die Struktur mit den entsprechenden Klassenattributen füllen, bevor Sie sie an die Funktion übergeben.

Rückgabewert

Typ: ATOM

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Klassenatom, das die zu registrierende Klasse eindeutig identifiziert. Dieses Atom kann nur von den Funktionen CreateWindow, CreateWindowEx, GetClassInfo, GetClassInfoEx, FindWindow, FindWindowEx und UnregisterClass und der IActiveIMMap::FilterClientWindows-Methode verwendet werden.

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

Hinweise

Wenn Sie die Fensterklasse mithilfe von RegisterClassExA registrieren, teilt die Anwendung dem System mit, dass die Fenster der erstellten Klasse erwarten, dass Nachrichten mit Text- oder Zeichenparametern den ANSI-Zeichensatz verwenden. wenn Sie sie mithilfe von RegisterClassExW registrieren, fordert die Anwendung an, dass das System Textparameter von Nachrichten als Unicode übergibt. Mit der IsWindowUnicode-Funktion können Anwendungen die Art jedes Fensters abfragen. Weitere Informationen zu ANSI- und Unicode-Funktionen finden Sie unter Konventionen für Funktionsprototypen.

Alle Fensterklassen, die eine Anwendung registriert, werden beim Beenden nicht registriert.

Keine von einer DLL registrierten Fensterklassen werden beim Entladen der DLL nicht registriert. Eine DLL muss die Registrierung ihrer Klassen explizit aufheben, wenn sie entladen wird.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Fensterklassen.

Hinweis

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

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