GetClassLongPtrA-Funktion (winuser.h)

Artikel
08/27/2023

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

Hinweis Verwenden Sie GetClassLongPtr, um Code zu schreiben, der sowohl mit 32-Bit- als auch mit 64-Bit-Versionen von Windows kompatibel ist. Beim Kompilieren 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 Byteoffset 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 angeben, wäre der Wert 16 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 von der RegisterClassEx-Funktion zurückgegeben wird.
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 Arbeitsspeicher 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 für das kleine 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 Fensterklassenstilbits 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 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 Wert ungleich null im cbClsExtra-Member der WNDCLASSEX-Struktur angeben, die mit der RegisterClassEx-Funktion verwendet wird.

Hinweis

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


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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-windowclass-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)