GetClassWord, fonction (winuser.h)

Article
03/04/2024

Récupère la valeur 16 bits (WORD) au décalage spécifié dans la mémoire de classe supplémentaire pour la classe window à laquelle appartient la fenêtre spécifiée.

Note Cette fonction est déconseillée pour toute utilisation autre que nIndex définie sur GCW_ATOM. La fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les applications doivent utiliser la fonction GetClassLong ou GetClassLongPtr .

Syntaxe

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

Paramètres

[in] hWnd

Type : HWND

Handle de la fenêtre et, indirectement, de la classe à laquelle la fenêtre appartient.

[in] nIndex

Type : int

Décalage d’octet de base zéro de la valeur à récupérer. Les valeurs valides sont comprises entre zéro et le nombre d’octets de mémoire de classe, moins deux ; par exemple, si vous avez spécifié 10 octets ou plus de mémoire de classe supplémentaire, une valeur de huit est un index du cinquième entier 16 bits. Il existe une valeur valide supplémentaire, comme indiqué dans le tableau suivant.

Valeur	Signification
GCW_ATOM -32	Récupère une valeur ATOM qui identifie de manière unique la classe window. Il s’agit du même atome que la fonction RegisterClass ou RegisterClassEx retourne.

Valeur retournée

Type : WORD

Si la fonction réussit, la valeur de retour est la valeur 16 bits demandée.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Réservez une mémoire de classe supplémentaire en spécifiant une valeur différente de zéro dans le membre cbClsExtra de la structure WNDCLASS utilisée avec la fonction RegisterClass .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-windowclass-l1-1-2 (introduit dans Windows 10, version 10.0.10240)