Funzione GetWindowLongPtrW (winuser.h)

Articolo
08/27/2023

Recupera informazioni sulla finestra specificata. La funzione recupera anche il valore in corrispondenza di un offset specificato nella memoria aggiuntiva della finestra.

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

Sintassi

LONG_PTR GetWindowLongPtrW(
  [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 in base zero al valore da recuperare. I valori validi si trovano nell'intervallo zero tramite il numero di byte di memoria finestra aggiuntiva, meno le dimensioni di un LONG_PTR. Per recuperare qualsiasi altro valore, specificare uno dei valori seguenti.

Valore	Significato
GWL_EXSTYLE -20	Recupera gli stili di finestra estesi.
GWLP_HINSTANCE -6	Recupera un handle nell'istanza dell'applicazione.
GWLP_HWNDPARENT -8	Recupera un handle nella finestra padre, se presente.
GWLP_ID -12	Recupera l'identificatore della finestra.
GWL_STYLE -16	Recupera gli stili della finestra.
GWLP_USERDATA -21	Recupera i dati utente associati alla finestra. Questi dati sono destinati all'uso da parte dell'applicazione che ha creato la finestra. Il valore è inizialmente zero.
GWLP_WNDPROC -4	Recupera il puntatore alla routine della finestra o un handle che rappresenta il puntatore alla routine della finestra. È necessario usare la funzione CallWindowProc per chiamare la routine della finestra.

I valori seguenti sono disponibili anche quando il parametro hWnd identifica una finestra di dialogo.

Valore	Significato
DWLP_DLGPROC DWLP_MSGRESULT + sizeof(LRESULT)	Recupera il puntatore alla procedura della finestra di dialogo o un handle che rappresenta il puntatore alla procedura della finestra di dialogo. È necessario usare la funzione CallWindowProc per chiamare la procedura della finestra di dialogo.
DWLP_MSGRESULT 0	Recupera il valore restituito di un messaggio elaborato nella procedura della finestra di dialogo.
DWLP_USER DWLP_DLGPROC + sizeof(DLGPROC)	Recupera informazioni aggiuntive private nell'applicazione, ad esempio handle o puntatori.

Valore restituito

Tipo: LONG_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.

Se SetWindowLong o SetWindowLongPtr non è stato chiamato in precedenza, GetWindowLongPtr restituisce zero per i valori nella finestra o nella memoria della classe aggiuntiva.

Commenti

Riservare memoria finestra aggiuntiva specificando un valore diverso da zero nel membro cbWndExtra della struttura WNDCLASSEX usato con la funzione RegisterClassEx .

Nota

L'intestazione winuser.h definisce GetWindowLongPtr 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-0 (introdotta in Windows 8)