IShellBrowser：：GetViewStateStream 方法 (shobjidl_core.h)

  • 项目

获取可用于存储特定于视图的状态信息的 IStream 接口。

语法

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

参数

grfMode

类型：DWORD

IStream 接口的读/写访问权限。 这可能是以下值之一。

STGM_READ

请求适合读取的 IStream 。

STGM_WRITE

请求适合写入的 IStream 。

STGM_READWRITE

请求适合读取和写入的 IStream 。

ppStrm

类型： IStream**

接收 IStream 接口指针的地址。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回 COM 定义的错误值。

注解

此方法用于保存和还原视图的持久状态 (图标位置、列宽和当前滚动位置，例如) 。

呼叫应用程序说明

在创建视图时使用 GetViewStateStream 以读取已保存的视图状态，以及关闭视图时，使用 GetViewStateStream 保存对视图状态所做的任何更改。 通常，视图在创建视图窗口时使用 STGM_READ 调用此方法，并在调用其 IShellView 接口的 SaveViewState 方法时使用 STGM_WRITE 调用此方法。

实施者说明

每个 Shell 视图都应有自己的视图流。 Windows 资源管理器实现最近使用的 (MRU) 基于每个用户存储在注册表中的视图流列表。

另请参阅 IShellBrowser

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll (4.0 或更高版本)