Funzione SetPropW (winuser.h)

Articolo
11/20/2024

Aggiunge una nuova voce o modifica una voce esistente nell'elenco delle proprietà della finestra specificata. La funzione aggiunge una nuova voce all'elenco se la stringa di caratteri specificata non esiste già nell'elenco. La nuova voce contiene la stringa e l'handle. In caso contrario, la funzione sostituisce l'handle corrente della stringa con l'handle specificato.

Sintassi

BOOL SetPropW(
  [in]           HWND    hWnd,
  [in]           LPCWSTR lpString,
  [in, optional] HANDLE  hData
);

Parametri

[in] hWnd

Tipo: HWND

Handle per la finestra di cui l'elenco delle proprietà riceve la nuova voce.

[in] lpString

Tipo: LPCTSTR

Stringa con terminazione Null o atom che identifica una stringa. Se questo parametro è un atomo, deve essere un atomo globale creato da una chiamata precedente alla funzione GlobalAddAtom. L'atomo deve essere posizionato nella parola in ordine basso di lpString; la parola di ordine elevato deve essere zero.

[in, optional] hData

Tipo: HANDLE

Handle per i dati da copiare nell'elenco delle proprietà. L'handle dati può identificare qualsiasi valore utile per l'applicazione.

Valore restituito

Tipo: bool

Se l'handle dati e la stringa vengono aggiunti all'elenco delle proprietà, il valore restituito è diverso da zero.

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

Osservazioni

Prima che una finestra venga eliminata definitivamente ,ovvero prima che venga restituita dall'elaborazione del messaggio di WM_NCDESTROY, un'applicazione deve rimuovere tutte le voci aggiunte all'elenco di proprietà. L'applicazione deve usare la funzione RemoveProp per rimuovere le voci.

SetProp è soggetto alle restrizioni dell'isolamento dei privilegi dell'interfaccia utente.SetProp is subject to the restrictions of User Interface Privilege Isolation (UIPI). Un processo può chiamare questa funzione solo in una finestra appartenente a un processo di livello di integrità minore o uguale. Quando UIPI blocca le modifiche alle proprietà, getLastError restituirà 5.

Esempi

Per un esempio, vedere Aggiunta di una proprietà Window.

Nota

L'intestazione winuser.h definisce SetProp 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-window-l1-1-4 (introdotto in Windows 10, versione 10.0.14393)