Freigeben über


RegisterClassExA-Funktion (winuser.h)

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

Syntax

ATOM RegisterClassExA(
  [in] const WNDCLASSEXA *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 Meldungen 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 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 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 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-windowclass-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

Createwindow

Createwindowex

Findwindow

FindWindowEx

GetClassInfo

GetClassInfoEx

Typedescriptor.getclassname

Referenz

Registerclass

UnregisterClass

WNDCLASSEX

Fensterklassen

WindowProc