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
Referenz