Funzione GetClassLongPtrA (winuser.h)

Articolo
11/20/2024

Recupera il valore specificato dalla struttura WNDCLASSEX associata alla finestra specificata.

Nota Per scrivere codice compatibile con entrambe le versioni a 32 bit e a 64 bit di Windows, usare GetClassLongPtr. Durante la compilazione per Windows a 32 bit, getClassLongPtr viene definita come chiamata alla funzione GetClassLong.

Sintassi

ULONG_PTR GetClassLongPtrA(
  [in] HWND hWnd,
  [in] int  nIndex
);

Parametri

[in] hWnd

Tipo: HWND

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

[in] nIndex

Tipo: int

Valore da recuperare. Per recuperare un valore dalla memoria della classe aggiuntiva, specificare l'offset di byte positivo e in base zero del valore da recuperare. I valori validi sono compresi nell'intervallo zero fino al numero di byte di memoria della classe aggiuntiva, meno otto; Ad esempio, se sono stati specificati 24 o più byte di memoria di classe aggiuntiva, un valore pari a 16 sarà un indice al terzo intero. Per recuperare qualsiasi altro valore dalla struttura di WNDCLASSEX , specificare uno dei valori seguenti.

Valore	Significato
GCW_ATOM -32	Recupera un valore atom che identifica in modo univoco la classe della finestra. Si tratta dello stesso atom restituito dalla funzione RegisterClassEx .
GCL_CBCLSEXTRA -20	Recupera le dimensioni, in byte, della memoria aggiuntiva associata alla classe .
GCL_CBWNDEXTRA -18	Recupera le dimensioni, in byte, della memoria della finestra aggiuntiva associata a ogni finestra della classe . Per informazioni su come accedere a questa memoria, vedere GetWindowLongPtr.
GCLP_HBRBACKGROUND -10	Recupera un handle nel pennello di sfondo associato alla classe .
GCLP_HCURSOR -12	Recupera un handle al cursore associato alla classe .
GCLP_HICON -14	Recupera un handle per l'icona associata alla classe .
GCLP_HICONSM -34	Recupera un handle per l'icona piccola associata alla classe .
GCLP_HMODULE -16	Recupera un handle per il modulo che ha registrato la classe .
GCLP_MENUNAME -8	Recupera il puntatore alla stringa del nome del menu. La stringa identifica la risorsa di menu associata alla classe .
GCL_STYLE -26	Recupera i bit di stile della classe finestra.
GCLP_WNDPROC -24	Recupera l'indirizzo della routine della finestra o un handle che rappresenta l'indirizzo della routine della finestra. Per chiamare la routine della finestra, è necessario usare la funzione CallWindowProc.

Valore restituito

Tipo: ULONG_PTR

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

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

Osservazioni

Riservare memoria di classe aggiuntiva specificando un valore diverso da zero nel membro cbClsExtra della struttura di WNDCLASSEX usata con la funzione RegisterClassEx .

Nota

L'intestazione winuser.h definisce GetClassLongPtr come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll
set di API	ext-ms-win-ntuser-windowclass-l1-1-2 (introdotto in Windows 10, versione 10.0.10240)