GetClassInfoW-Funktion (winuser.h)

Artikel
03/09/2024

Ruft Informationen zu einer Fensterklasse ab.

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

Syntax

BOOL GetClassInfoW(
  [in, optional] HINSTANCE   hInstance,
  [in]           LPCWSTR     lpClassName,
  [out]          LPWNDCLASSW lpWndClass
);

Parameter

[in, optional] hInstance

Typ: HINSTANCE

Ein Handle für die instance der Anwendung, die die -Klasse erstellt hat. Um Informationen zu vom System definierten Klassen abzurufen (z. B. Schaltflächen oder Listenfelder), legen Sie diesen Parameter auf NULL fest.

[in] lpClassName

Typ: LPCTSTR

Der Name der Klasse. 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 es sich bei diesem Parameter um ein Atom handelt. Wenn ja, muss es sich um ein Klassenatom handeln, das durch einen vorherigen Aufruf von RegisterClass oder RegisterClassEx erstellt wurde. Das Atom muss sich in der niedrigen Reihenfolge des Worts lpClassName befinden. das wort mit hoher Ordnung muss 0 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 nonzero.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der winuser.h-Header definiert GetClassInfo 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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-windowclass-l1-1-0 (eingeführt in Windows 8)