RegisterClassA-Funktion (winuser.h)

Artikel
03/04/2024

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

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

Syntax

ATOM RegisterClassA(
  [in] const WNDCLASSA *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.

Hinweise

Wenn Sie die Fensterklasse mithilfe von RegisterClassA 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 RegisterClassW 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 Zuordnen einer Fensterprozedur 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 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)