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

Establece el nombre del contenedor de propiedades.

Sintaxis

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Parámetros

[in] pszPropertyBag

Tipo: LPCWSTR

Puntero a una cadena Unicode constante terminada en null que contiene el nombre del contenedor de propiedades. La información de estado de vista específica de la aplicación del cliente se almacena (se conserva) con este nombre.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

ExplorerBrowser puede recuperar las propiedades almacenadas en el contenedor de propiedades llamando a la función SHGetViewStatePropertyBag. ExplorerBrowser escribe en este contenedor de propiedades que también se almacena (se conserva) en el registro. La persistencia se produce automáticamente cuando ExplorerBrowser destruye la vista actual, inicia una navegación o se destruye. Después de cualquiera de estos eventos, escribe información sobre el estado de vista en caso de que el usuario la haya modificado.

Si no se han almacenado propiedades, se usa el estado de vista predeterminado del exploradorBrowser. El estado de vista predeterminado es el estado de vista que el usuario ha establecido para una ubicación determinada, o si el estado de vista de una ubicación no se ha establecido (nunca modificado por el usuario), el estado de vista predeterminado se basa en la plantilla para el tipo de archivo (por ejemplo, documentos, música e imágenes) en la ubicación. Todas las ventanas del Explorador usan la misma secuencia para determinar el estado de vista predeterminado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)