GetClassInfoExA-Funktion (winuser.h)
Ruft Informationen zu einer Fensterklasse ab, einschließlich eines Handles zum kleinen Symbol, das der Fensterklasse zugeordnet ist. Die GetClassInfo--Funktion ruft kein Handle zum kleinen 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 Instanz der Anwendung, die die Klasse erstellt hat. Um Informationen zu klassen abzurufen, die vom System definiert werden (z. B. Schaltflächen oder Listenfelder), legen Sie diesen Parameter auf NULL-fest.
[in] lpszClass
Typ: LPCTSTR-
Der Klassenname. Der Name muss der einer vorregistrierten Klasse oder einer Klasse sein, die von einem vorherigen Aufruf der RegisterClass oder RegisterClassEx-Funktion registriert wurde. Alternativ kann dieser Parameter ein Klassenatom sein, das durch einen vorherigen Aufruf von RegisterClass oder RegisterClassExerstellt wurde. Das Atom muss im Wort "low-order" von lpszClasssein; Das Wort "Hochreihenfolge" muss null sein.
[out] lpwcx
Typ: LPWNDCLASSEX
Ein Zeiger auf eine WNDCLASSEX--Struktur, die die Informationen zur 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. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Klassenatome werden mithilfe der funktion RegisterClass oder RegisterClassEx und nicht der GlobalAddAtom-Funktion erstellt.
Anmerkung
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 |
|---|---|
| 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-