Funzione GetClassWord (winuser.h)

Articolo
03/13/2024

Recupera il valore a 16 bit (WORD) all'offset specificato nella memoria di classe aggiuntiva per la classe finestra a cui appartiene la finestra specificata.

Nota Questa funzione è deprecata per qualsiasi uso diverso da nIndex impostato su GCW_ATOM. La funzione viene fornita solo per la compatibilità con le versioni a 16 bit di Windows. Le applicazioni devono usare la funzione GetClassLong o GetClassLongPtr.

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle alla finestra e, indirettamente, alla classe a cui appartiene la finestra.

[in] nIndex

Tipo: int

Offset di byte in base zero del valore da recuperare. I valori validi si trovano nell'intervallo zero tramite il numero di byte di memoria della classe, meno due; ad esempio, se si specificano 10 o più byte di memoria di classe aggiuntiva, un valore di otto sarebbe un indice al quinto intero a 16 bit. Nella tabella seguente è presente un valore valido aggiuntivo.

Valore	Significato
GCW_ATOM -32	Recupera un valore ATOM che identifica in modo univoco la classe della finestra. Si tratta dello stesso atomo restituito dalla funzione RegisterClass o RegisterClassEx .

Valore restituito

Tipo: WORD

Se la funzione ha esito positivo, il valore restituito è il valore a 16 bit richiesto.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Riservare memoria di classe aggiuntiva specificando un valore diverso da zero nel membro cbClsExtra della struttura WNDCLASS usato con la funzione RegisterClass .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-windowclass-l1-1-2 (introdotta in Windows 10, versione 10.0.10240)