RegisterClassW-Funktion (winuser.h)

Artikel
07/21/2023

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

Hinweis Die RegisterClass-Funktion wurde durch die RegisterClassEx-Funktion ersetzt. Sie können RegisterClass jedoch weiterhin verwenden, wenn Sie das Kleine Symbol für die Klasse nicht festlegen müssen.

Syntax

ATOM RegisterClassW(
  [in] const WNDCLASSW *lpWndClass
);

Parameter

[in] lpWndClass

Typ: const WNDCLASS*

Ein Zeiger auf eine WNDCLASS-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.

Bemerkungen

Wenn Sie die Fensterklasse mithilfe von RegisterClassA registrieren, teilt die Anwendung dem System mit, dass die Fenster der erstellten Klasse erwarten, dass Meldungen mit Text- oder Zeichenparametern den ANSI-Zeichensatz verwenden. Wenn Sie sie mithilfe von RegisterClassW registrieren, fordert die Anwendung an, dass das System Textparameter von Nachrichten als Unicode übergibt. Mit der IsWindowUnicode-Funktion können Anwendungen die Art der einzelnen Fenster 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 nicht registriert, wenn die DLL entladen wird. Eine DLL muss die Registrierung ihrer Klassen explizit aufheben, wenn sie entladen wird.

Beispiele

Ein Beispiel finden Sie unter Zuordnen einer Window-Prozedur zu einer Window-Klasse.

Hinweis

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


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