Метод IExplorerBrowser::SetPropertyBag (shobjidl_core.h)

Задает имя контейнера свойств.

Синтаксис

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

Параметры

[in] pszPropertyBag

Тип: LPCWSTR

Указатель на константную строку Юникода с пустым завершением, которая содержит имя контейнера свойств. Сведения о состоянии просмотра, относящиеся к приложению клиента, хранятся (сохраняются) с помощью этого имени.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

ExplorerBrowser может получить свойства, хранящиеся в контейнере свойств, вызвав функцию SHGetViewStatePropertyBag. ExplorerBrowser записывает данные в этот контейнер свойств, который также хранится (сохраняется) в реестре. Сохраняемость происходит автоматически, когда ExplorerBrowser уничтожает текущее представление, начинает навигацию или удаляется. После любого из этих событий он записывает сведения о состоянии представления, если оно было изменено пользователем.

Если свойства не сохранены, используется состояние представления explorerBrowser по умолчанию. Состояние представления по умолчанию — это состояние представления, заданное пользователем для определенного расположения, или, если состояние представления для расположения не было задано (пользователь никогда не изменял), то состояние представления по умолчанию основано на шаблоне для типа файла (например, документы, музыка и изображения) в этом расположении. Все Обозреватель окна используют одну последовательность для определения состояния представления по умолчанию.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)