Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Registriert eine Fensterklasse für die nachfolgende Verwendung in Aufrufen der CreateWindow- oder CreateWindowEx--Funktion.
Hinweis Die funktion RegisterClass wurde durch die funktion RegisterClassEx ersetzt. Sie können weiterhin RegisterClassverwenden, wenn Sie das kleine Symbol der Klasse jedoch 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, der die registrierte Klasse eindeutig identifiziert. Dieses Atom kann nur von der
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn Sie die Fensterklasse mithilfe von RegisterClassAregistrieren, teilt die Anwendung dem System mit, dass die Fenster der erstellten Klasse Nachrichten mit Text- oder Zeichenparametern für die Verwendung des ANSI-Zeichensatzes erwarten; Wenn Sie sie mit RegisterClassWregistrieren, 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.
Beim Entladen der DLL werden keine Von einer DLL registrierten Fensterklassen aufgehoben. Eine DLL muss die Registrierung ihrer Klassen explizit aufheben, wenn sie entladen wird.
Beispiele
Ein Beispiel finden Sie unter Associating a Window Procedure with a Window Class.
Anmerkung
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
| API-Satz | ext-ms-win-ntuser-windowclass-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzeptionelle
Referenz-