Metodo IExplorerBrowser::SetPropertyBag (shobjidl_core.h)

Imposta il nome del contenitore delle proprietà.

Sintassi

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Parametri

[in] pszPropertyBag

Tipo: LPCWSTR

Puntatore a una stringa Unicode costante con terminazione Null contenente il nome del contenitore delle proprietà. Visualizzare le informazioni sullo stato specifiche dell'applicazione del client vengono archiviate (rese persistenti) usando questo nome.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

ExplorerBrowser può recuperare le proprietà archiviate nel contenitore delle proprietà chiamando la funzione SHGetViewStatePropertyBag. ExplorerBrowser scrive in questo contenitore di proprietà che viene archiviato (persistente) anche nel Registro di sistema. La persistenza si verifica automaticamente quando ExplorerBrowser elimina definitivamente la visualizzazione corrente, avvia una navigazione o viene eliminata definitivamente. Dopo uno di questi eventi, scrive informazioni sullo stato di visualizzazione nel caso in cui sia stata modificata dall'utente.

Se non sono state archiviate proprietà, viene utilizzato lo stato di visualizzazione predefinito di ExplorerBrowser. Lo stato di visualizzazione predefinito è lo stato di visualizzazione impostato dall'utente per una posizione specifica o se lo stato di visualizzazione per una posizione non è stato impostato (mai modificato dall'utente), lo stato di visualizzazione predefinito è basato sul modello per il tipo di file (ad esempio documenti, musica e immagini) nella posizione. Tutte le finestre di Esplora risorse usano la stessa sequenza per determinare lo stato di visualizzazione predefinito.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)