SetClassWord-Funktion (winuser.h)

Artikel
08/28/2023

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

Hinweis Diese Funktion wird nur zur Kompatibilität mit 16-Bit-Versionen von Windows bereitgestellt. Anwendungen sollten die SetClassLong-Funktion verwenden.

Syntax

WORD SetClassWord(
  [in] HWND hWnd,
  [in] int  nIndex,
  [in] WORD wNewWord
);

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 zu ersetzenden Werts. Gültige Werte liegen im Bereich 0 durch die Anzahl der Bytes des Klassenspeichers minus zwei; Wenn Sie beispielsweise 10 oder mehr Bytes des zusätzlichen Klassenspeichers angegeben haben, wäre ein Wert von 8 ein Index für die fünfte ganze 16-Bit-Zahl.

[in] wNewWord

Typ: WORD

Der Ersetzungswert.

Rückgabewert

Typ: WORD

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vorherige Wert der angegebenen 16-Bit-Ganzzahl. Wenn der Wert zuvor nicht festgelegt wurde, ist der Rückgabewert 0.

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 nonzero-Wert im cbClsExtra-Member der WNDCLASS-Struktur angeben, die mit der RegisterClass-Funktion verwendet wird.

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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll