Funzione GetPropW (winuser.h)

Articolo
03/15/2023

Recupera un handle di dati dall'elenco delle proprietà della finestra specificata. La stringa di caratteri identifica l'handle da recuperare. La stringa e l'handle devono essere stati aggiunti all'elenco di proprietà da una chiamata precedente alla funzione SetProp .

Sintassi

HANDLE GetPropW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpString
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra di cui eseguire la ricerca nell'elenco di proprietà.

[in] lpString

Tipo: LPCTSTR

Atomo che identifica una stringa. Se questo parametro è un atom, deve essere stato creato usando la funzione GlobalAddAtom . L'atomo, un valore a 16 bit, deve essere inserito nella parola in ordine basso del parametro lpString ; la parola di ordine elevato deve essere zero.

Valore restituito

Tipo: HANDLE

Se l'elenco di proprietà contiene la stringa, il valore restituito è l'handle dati associato. In caso contrario, il valore restituito è NULL.

Commenti

Nota

L'intestazione winuser.h definisce GetProp 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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-window-l1-1-0 (introdotto in Windows 8)