GetClassLongPtrA-Funktion (winuser.h)

Artikel
11/20/2024

Ruft den angegebenen Wert aus der WNDCLASSEX- Struktur ab, die dem angegebenen Fenster zugeordnet ist.

Hinweis Verwenden Sie GetClassLongPtr, um Code zu schreiben, der mit 32-Bit- und 64-Bit-Versionen von Windows kompatibel ist. Bei der Kompilierung für 32-Bit-Windows wird GetClassLongPtr- als Aufruf der GetClassLong--Funktion definiert.

Syntax

ULONG_PTR GetClassLongPtrA(
  [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 Byte-Offset des abzurufenden Werts an. Gültige Werte liegen im Bereich 0 bis zur Anzahl der Bytes des zusätzlichen Klassenspeichers minus acht; Wenn Sie beispielsweise 24 oder mehr Bytes zusätzlichen Klassenspeicher angegeben haben, wäre ein Wert von 16 ein Index für die dritte ganze Zahl. Um einen anderen Wert aus der WNDCLASSEX--Struktur abzurufen, geben Sie einen der folgenden Werte an.

Wert	Bedeutung
GCW_ATOM -32	Ruft einen ATOM Wert ab, der die Fensterklasse eindeutig identifiziert. Dies ist dasselbe Atom, das die RegisterClassEx--Funktion zurückgibt.
GCL_CBCLSEXTRA -20	Ruft die Größe des zusätzlichen Arbeitsspeichers in Bytes 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 Zugreifen auf diesen Speicher finden Sie unter GetWindowLongPtr.
GCLP_HBRBACKGROUND -10	Ruft ein Handle für den Hintergrundpinsel ab, der der Klasse zugeordnet ist.
GCLP_HCURSOR -12	Ruft ein Handle für den Cursor ab, der der Klasse zugeordnet ist.
GCLP_HICON -14	Ruft ein Handle zum Symbol ab, das der Klasse zugeordnet ist.
GCLP_HICONSM -34	Ruft ein Handle zum kleinen Symbol ab, das der Klasse zugeordnet ist.
GCLP_HMODULE -16	Ruft ein Handle für das Modul ab, das die Klasse registriert hat.
GCLP_MENUNAME -8	Ruft den Zeiger auf die Menünamenzeichenfolge ab. Die Zeichenfolge identifiziert die Menüressource, die der Klasse zugeordnet ist.
GCL_STYLE -26	Ruft die Bits im Fensterklassenstil ab.
GCLP_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

Typ: ULONG_PTR

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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

Anmerkung

Der winuser.h-Header definiert GetClassLongPtr 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-2 (eingeführt in Windows 10, Version 10.0.10240)