GetClassWord-Funktion (winuser.h)

Artikel
13.03.2024

Ruft den 16-Bit-Wert (WORD) am angegebenen Offset in den zusätzlichen Klassenspeicher für die Fensterklasse ab, zu der das angegebene Fenster gehört.

Hinweis Diese Funktion ist für jede andere Verwendung als nIndex veraltet, die auf GCW_ATOM festgelegt ist. Die Funktion wird nur aus Gründen der Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die Funktion GetClassLong oder GetClassLongPtr verwenden.

Syntax

C++

WORD GetClassWord(
  [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 nullbasierte Byteoffset des abzurufenden Werts. Gültige Werte liegen im Bereich 0 bis zur Anzahl der Bytes des Klassenspeichers, minus zwei; Wenn Sie beispielsweise 10 oder mehr Bytes zusätzlichen Klassenspeicher angeben, wäre der Wert acht ein Index für die fünfte 16-Bit-Ganzzahl. Es gibt einen zusätzlichen gültigen Wert, wie in der folgenden Tabelle gezeigt.

Wert	Bedeutung
GCW_ATOM -32	Ruft einen ATOM-Wert ab, der die Fensterklasse eindeutig identifiziert. Dies ist dasselbe Atom, das von der RegisterClass - oder RegisterClassEx-Funktion zurückgegeben wird.

Rückgabewert

Typ: WORD

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der angeforderte 16-Bit-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 WNDCLASS-Struktur angeben, die mit der RegisterClass-Funktion verwendet wird.

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 (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)