Méthode IExplorerBrowser ::SetPropertyBag (shobjidl_core.h)

Définit le nom du conteneur de propriétés.

Syntaxe

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Paramètres

[in] pszPropertyBag

Type : LPCWSTR

Pointeur vers une chaîne Unicode constante, terminée par null, qui contient le nom du conteneur de propriétés. Les informations d’état d’affichage spécifiques à l’application du client sont stockées (persistantes) à l’aide de ce nom.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

ExplorerBrowser peut récupérer les propriétés stockées dans le conteneur de propriétés en appelant la fonction SHGetViewStatePropertyBag. ExplorerBrowser écrit dans ce conteneur de propriétés qui est également stocké (conservé) dans le Registre. La persistance se produit automatiquement quand ExplorerBrowser détruit l’affichage actuel, commence une navigation ou est détruit. Après l’un de ces événements, il écrit des informations sur l’état d’affichage si celui-ci a été modifié par l’utilisateur.

Si aucune propriété n’a été stockée, l’état d’affichage par défaut de l’explorateurBrowser est utilisé. L’état d’affichage par défaut est l’état d’affichage que l’utilisateur a défini pour un emplacement particulier, ou si l’état d’affichage d’un emplacement n’a pas été défini (jamais modifié par l’utilisateur), l’état d’affichage par défaut est basé sur le modèle du type de fichier (par exemple, documents, musique et images) à l’emplacement. Toutes les fenêtres Explorer utilisent la même séquence pour déterminer l’état d’affichage par défaut.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)