GetClassInfoA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft Informationen zu einer Fensterklasse ab.

Hinweis Die GetClassInfo--Funktion wurde durch die GetClassInfoEx-Funktion ersetzt. Sie können weiterhin GetClassInfo-verwenden, wenn Sie jedoch keine Informationen zum kleinen Symbol der Klasse benötigen.

Syntax

BOOL GetClassInfoA(
  [in, optional] HINSTANCE   hInstance,
  [in]           LPCSTR      lpClassName,
  [out]          LPWNDCLASSA lpWndClass
);

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] lpClassName

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 Atom sein. Wenn ja, muss es sich um ein Klassenatom handeln, das von einem vorherigen Aufruf von RegisterClass oder RegisterClassEx-erstellt wurde. Das Atom muss sich im Wort "low-order" von lpClassName; Das Wort "Hochreihenfolge" muss null sein.

[out] lpWndClass

Typ: LPWNDCLASS

Ein Zeiger auf eine WNDCLASS--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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der winuser.h-Header definiert GetClassInfo als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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)