GetClassInfoExA-Funktion (winuser.h)
Ruft Informationen zu einer Fensterklasse ab, einschließlich eines Handles für das kleine Symbol, das der Fensterklasse zugeordnet ist. Die GetClassInfo-Funktion ruft kein Handle für das kleine Symbol ab.
Syntax
BOOL GetClassInfoExA(
[in, optional] HINSTANCE hInstance,
[in] LPCSTR lpszClass,
[out] LPWNDCLASSEXA lpwcx
);
Parameter
[in, optional] hInstance
Typ: HINSTANCE
Ein Handle für die instance der Anwendung, die die -Klasse erstellt hat. Legen Sie diesen Parameter auf NULL fest, um Informationen zu vom System definierten Klassen abzurufen (z. B. Schaltflächen oder Listenfelder).
[in] lpszClass
Typ: LPCTSTR
Der Name der Klasse. Der Name muss der einer vorregistrierten Klasse oder einer Klasse sein, die durch einen vorherigen Aufruf der RegisterClass - oder RegisterClassEx-Funktion registriert wurde. Alternativ kann es sich bei diesem Parameter um ein Klassenatom handeln, das durch einen vorherigen Aufruf von RegisterClass oder RegisterClassEx erstellt wurde. Das Atom muss sich im Wort "low-order" von lpszClass befinden; Das Wort mit hoher Ordnung muss 0 (null) sein.
[out] lpwcx
Typ: LPWNDCLASSEX
Ein Zeiger auf eine WNDCLASSEX-Struktur , die die Informationen über die -Klasse empfängt.
Rückgabewert
Typ: BOOL
Wenn die Funktion eine übereinstimmende Klasse findet und die Daten erfolgreich kopiert, ist der Rückgabewert ungleich null.
Wenn die Funktion keine übereinstimmende Klasse findet und die Daten erfolgreich kopiert, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Klassenatome werden mit der RegisterClass - oder RegisterClassEx-Funktion erstellt, nicht mit der GlobalAddAtom-Funktion .
Hinweis
Der winuser.h-Header definiert GetClassInfoEx 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