Compartir a través de

Método IShellBrowser::GetViewStateStream (shobjidl_core.h)

  • Artículo

Obtiene una interfaz IStream que se puede usar para almacenar información de estado específica de la vista.

Sintaxis

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

Parámetros

grfMode

Tipo: DWORD

Acceso de lectura y escritura de la interfaz IStream . Puede ser uno de los siguientes valores.

STGM_READ

Solicita un IStream adecuado para leer.

STGM_WRITE

Solicita un IStream adecuado para escribir.

STGM_READWRITE

Solicita un IStream adecuado para leer y escribir.

ppStrm

Tipo: IStream**

Dirección que recibe el puntero de la interfaz IStream .

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error definido por COM en caso contrario.

Comentarios

Este método se usa para guardar y restaurar el estado persistente de una vista (las posiciones del icono, los anchos de columna y la posición de desplazamiento actual, por ejemplo).

Notas a las aplicaciones de llamada

Use GetViewStateStream cuando se crea la vista para leer en el estado de vista guardado y también cuando se cierra la vista para guardar los cambios en el estado de vista. Normalmente, la vista llama a este método con STGM_READ al crear una ventana de vista y con STGM_WRITE cuando se llama al método SaveViewState de su interfaz IShellView .

Notas para los implementadores

Cada vista de Shell debe tener su propia secuencia de vistas. El Explorador de Windows implementa una lista de flujos de vista usados más recientemente (MRU) que se almacenan por usuario en el registro.

Consulte también IShellBrowser.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll (versión 4.0 o posterior)