Funzione GetClassLongPtrA (winuser.h)

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

Nota Per scrivere codice compatibile sia con versioni a 32 bit che a 64 bit di Windows, usare GetClassLongPtr. Quando si compila per Windows a 32 bit, GetClassLongPtr viene definito come chiamata alla funzione GetClassLong .
 

Sintassi

ULONG_PTR GetClassLongPtrA(
  [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

Valore da recuperare. Per recuperare un valore dalla memoria di classe aggiuntiva, specificare l'offset di byte positivo e in base zero del valore da recuperare. I valori validi si trovano nell'intervallo zero attraverso il numero di byte di memoria di classe aggiuntiva, meno otto; ad esempio, se si specificano 24 o più byte di memoria di classe aggiuntiva, un valore pari a 16 è un indice al terzo intero. Per recuperare qualsiasi altro valore dalla struttura 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 atomo 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 all'icona associata alla classe.
GCLP_HICONSM
-34
Recupera un handle per l'icona piccola associata alla classe.
GCLP_HMODULE
-16
Recupera un handle al modulo che ha registrato la classe.
GCLP_MENUNAME
-8
Recupera il puntatore alla stringa del nome del menu. La stringa identifica la risorsa del menu associata alla classe.
GCL_STYLE
-26
Recupera i bit di stile della classe di finestra.
GCLP_WNDPROC
-24
Recupera l'indirizzo della routine della finestra o un handle che rappresenta l'indirizzo della routine della finestra. È necessario usare la funzione CallWindowProc per chiamare la routine della finestra.

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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Riservare memoria di classe aggiuntiva specificando un valore diverso da zero nel membro cbClsExtra della struttura WNDCLASSEX utilizzata 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
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)

Vedi anche

Informazioni concettuali

GetWindowLongPtr

Riferimento

RegisterClassEx

SetClassLongPtr

WNDCLASSEX

Classi finestra