Метод IShellBrowser::GetViewStateStream (shobjidl_core.h)

Статья
08/26/2023

Возвращает интерфейс 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 при создании представления для чтения в сохраненном состоянии представления, а также при закрытии представления, чтобы сохранить изменения в состоянии представления. Как правило, представление вызывает этот метод с STGM_READ при создании окна представления и с STGM_WRITE при вызове метода SaveViewState интерфейса IShellView .

Примечания для разработчиков

Каждое представление оболочки должно иметь собственный поток представления. Windows Обозреватель реализует список недавно использовавшихся потоков представлений, которые хранятся в реестре для отдельных пользователей.

См. также IShellBrowser.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)
DLL	Shell32.dll (версия 4.0 или более поздняя)

Поделиться через