GetWindowWord-Funktion (winuser.h)

Artikel
03/22/2023

Ruft den 16-Bit-Wert (DWORD) am angegebenen Offset in den zusätzlichen Fensterspeicher ab.

Syntax

WORD GetWindowWord(
  HWND hWnd,
  int  nIndex
);

Parameter

hWnd

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

nIndex

Der nullbasierte Offset auf den abzurufenden Wert. Gültige Werte liegen im Bereich Null durch die Anzahl der Bytes des zusätzlichen Fensterspeichers, minus vier; Wenn Sie beispielsweise 12 oder mehr Bytes zusätzlichen Arbeitsspeicher angegeben haben, wäre ein Wert von 8 ein Index für die dritte 32-Bit-Ganzzahl. Geben Sie einen der folgenden Werte an, um einen anderen Wert abzurufen.

Konstante	Wert	Bedeutung
GWW_HINSTANCE	-6	Ruft ein Handle für die Anwendungsinstanz ab.
GWW_HWNDPARENT -8	Ruft ggf. ein Handle zum übergeordneten Fenster ab.
GWW_ID	-12	Ruft den Bezeichner des Fensters ab.

Rückgabewert

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 Fensterspeicher, indem Sie einen nonzero-Wert im cbWndExtra-Member der WNDCLASSEX-Struktur angeben, die mit der RegisterClassEx-Funktion verwendet wird.

Requirements (Anforderungen)


Kopfzeile	winuser.h

Freigeben über