Funzione GetPropA (winuser.h)

Articolo
03/04/2024

Recupera un handle 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 GetPropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Parametri

[in] hWnd

Tipo: HWND

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

[in] lpString

Tipo: LPCTSTR

Atom che identifica una stringa. Se questo parametro è un atomo, deve essere stato creato usando la funzione GlobalAddAtom . L'atomo, un valore a 16 bit, deve essere inserito nella parola a basso ordine 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 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

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