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

Obtém uma interface IStream que pode ser usada para o armazenamento de informações de estado específicas da exibição.

Sintaxe

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

Parâmetros

grfMode

Tipo: DWORD

Acesso de leitura/gravação da interface IStream . Esse pode ser um dos valores a seguir.

STGM_READ

Solicita um IStream adequado para leitura.

STGM_WRITE

Solicita um IStream adequado para gravação.

STGM_READWRITE

Solicita um IStream adequado para leitura e gravação.

ppStrm

Tipo: IStream**

O endereço que recebe o ponteiro da interface IStream .

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro definido por COM caso contrário.

Comentários

Esse método é usado para salvar e restaurar o estado persistente de uma exibição (as posições de ícone, as larguras de coluna e a posição de rolagem atual, por exemplo).

Anotações para aplicativos de chamada

Use GetViewStateStream quando a exibição estiver sendo criada para ler no estado de exibição salvo e também quando a exibição estiver sendo fechada para salvar as alterações no estado de exibição. Normalmente, a exibição chama esse método com STGM_READ ao criar uma janela de exibição e com STGM_WRITE quando o método SaveViewState de sua interface IShellView é chamado.

Anotações aos implementadores

Cada exibição do Shell deve ter seu próprio fluxo de exibição. O Windows Explorer implementa uma lista de fluxos de exibição usados mais recentemente (MRU) armazenados por usuário no Registro.

Consulte também IShellBrowser

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll (versão 4.0 ou posterior)