GetClassLongA-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 abgelöst. (Zeiger und Handles sind 32 Bit unter 32-Bit-Windows und 64 Bit unter 64-Bit-Windows.)

Syntax

DWORD GetClassLongA(
  [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 vier; Wenn Sie beispielsweise 12 oder mehr Bytes zusätzlichen Klassenspeicher angeben, 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 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 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ünamenszeichenfolge ab. Die Zeichenfolge identifiziert die Menüressource, die der -Klasse zugeordnet ist.
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 Wert ungleich null 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 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-1 (eingeführt in Windows 8.1)