GetClassLongW-Funktion (winuser.h)

Artikel
08/27/2023

Ruft den angegebenen 32-Bit-Wert (DWORD) aus der WNDCLASSEX-Struktur ab, die dem angegebenen Fenster zugeordnet ist.

Hinweis Wenn Sie einen Zeiger oder ein Handle abrufen, wurde diese Funktion durch die GetClassLongPtr-Funktion ersetzt. (Zeiger und Handles sind 32 Bits unter 32-Bit-Windows und 64 Bit unter 64-Bit-Windows.)

Syntax

DWORD GetClassLongW(
  [in] HWND hWnd,
  [in] int  nIndex
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster und indirekt die Klasse, zu der das Fenster gehört.

[in] nIndex

Typ: int

Der abzurufende Wert. Um einen Wert aus dem zusätzlichen Klassenspeicher abzurufen, geben Sie den positiven, nullbasierten Byteoffset des abzurufenden Werts an. Gültige Werte liegen im Bereich Null durch die Anzahl der Bytes des zusätzlichen Klassenspeichers, minus vier; Wenn Sie beispielsweise 12 oder mehr Bytes zusätzlichen Klassenspeicher angegeben haben, wäre der Wert 8 ein Index für die dritte ganze Zahl. Geben Sie einen der folgenden Werte an, um einen anderen Wert aus der WNDCLASSEX-Struktur abzurufen.

Wert	Bedeutung
GCW_ATOM -32	Ruft einen ATOM-Wert ab, der die Fensterklasse eindeutig identifiziert. Dies ist das gleiche Atom, das die RegisterClassEx-Funktion zurückgibt.
GCL_CBCLSEXTRA -20	Ruft die Größe des zusätzlichen Arbeitsspeichers ab, der der Klasse zugeordnet ist.
GCL_CBWNDEXTRA –18	Ruft die Größe des zusätzlichen Fensterspeichers in Bytes ab, der jedem Fenster in der Klasse zugeordnet ist. Informationen zum Zugriff auf diesen Arbeitsspeicher finden Sie unter GetWindowLong.
GCL_HBRBACKGROUND -10	Ruft ein Handle für den Hintergrundpinsel ab, der der -Klasse zugeordnet ist.
GCL_HCURSOR -12	Ruft ein Handle für den Cursor ab, der der Klasse zugeordnet ist.
GCL_HICON -14	Ruft ein Handle zum Symbol ab, das der Klasse zugeordnet ist.
GCL_HICONSM -34	Ruft ein Handle für das kleine Symbol ab, das der Klasse zugeordnet ist.
GCL_HMODULE -16	Ruft ein Handle für das Modul ab, das die -Klasse registriert hat.
GCL_MENUNAME -8	Ruft die Adresse der Menünamenzeichenfolge ab. Die Zeichenfolge identifiziert die der -Klasse zugeordnete Menüressource.
GCL_STYLE -26	Ruft die Fensterklassenstilbits ab.
GCL_WNDPROC -24	Ruft die Adresse der Fensterprozedur oder ein Handle ab, das die Adresse der Fensterprozedur darstellt. Sie müssen die CallWindowProc-Funktion verwenden, um die Fensterprozedur aufzurufen.

Rückgabewert

Art: DWORD

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der angeforderte Wert.

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

Hinweise

Reservieren Sie zusätzlichen Klassenspeicher, indem Sie einen nonzero-Wert im cbClsExtra-Member der WNDCLASSEX-Struktur angeben, die mit der RegisterClassEx-Funktion verwendet wird.

Hinweis

Der winuser.h-Header definiert GetClassLong 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-1 (eingeführt in Windows 8.1)