IExplorerBrowser：：SetPropertyBag 方法 (shobjidl_core.h)

设置属性包的名称。

语法

HRESULT SetPropertyBag(
  [in] LPCWSTR pszPropertyBag
);

参数

[in] pszPropertyBag

类型： LPCWSTR

指向常量、以 null 结尾的 Unicode 字符串的指针，该字符串包含属性包的名称。 特定于客户端应用程序的视图状态信息存储在使用此名称 (持久化) 。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

ExplorerBrowser 可以通过调用函数 SHGetViewStatePropertyBag 检索存储在属性包中的属性。 ExplorerBrowser 写入此属性包，该包也存储在注册表中 (持久化) 。 当 ExplorerBrowser 销毁当前视图、开始导航或销毁时，会自动发生持久性。 在发生上述任何事件后，它会写入有关视图状态的信息，以防用户对其进行修改。

如果未存储任何属性，则使用 ExplorerBrowser 的默认视图状态。 默认视图状态是用户已为特定位置设置的视图状态，或者，如果某个位置的视图状态尚未设置 (用户从未修改过) ，则默认视图状态基于文件类型 (模板，例如，文档、音乐和图片) 位置。 所有资源管理器窗口都使用相同的序列来确定默认视图状态。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shobjidl_core.h (包括 Shobjidl.h)