Freigeben über


GetWindowWord-Funktion (winuser.h)

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

Syntax

WORD GetWindowWord(
  HWND hWnd,
  int  nIndex
);

Die 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 0 bis zur 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. Um einen anderen Wert abzurufen, geben Sie einen der folgenden Werte an.

Dauerhaft Wert Bedeutung
GWW_HINSTANCE –6 Ruft ein Handle für die Anwendungsinstanz ab.
GWW_HWNDPARENT -8 Ruft ggf. ein Handle für das übergeordnete 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

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

Anforderungen

Anforderung Wert
Header winuser.h
Library User32.Lib