Método IOleDocumentView::SaveViewState (docobj.h)

Salva o estado de exibição no fluxo especificado.

Sintaxe

HRESULT SaveViewState(
  [in] LPSTREAM pstm
);

Parâmetros

[in] pstm

Um ponteiro para o fluxo no qual a exibição deve salvar seus dados de estado.

Retornar valor

Esse método retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_POINTER	O valor em pstm é NULL.
E_NOTIMPL	Essa exibição não tem nenhum estado significativo para salvar. Esse erro deve ser raro porque a maioria das exibições tem pelo menos algumas informações de estado que valem a pena salvar.

Comentários

O estado da exibição inclui propriedades como o tipo de exibição, o fator de zoom e o local do ponto de inserção. O contêiner normalmente chama essa função antes de desativar o modo de exibição. O fluxo pode ser usado posteriormente para reinicializar uma exibição do mesmo documento para esse estado salvo por meio de IOleDocumentView::ApplyViewState.

De acordo com as regras que regem IPersistStream, uma exibição deve gravar seu CLSID como o primeiro elemento no fluxo. Quaisquer problemas de compatibilidade de formato de arquivo multiplataforma que se aplicam à representação de armazenamento do documento também se aplicam a esse contexto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [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	docobj.h

Confira também

Ioledocumentview

IOleDocumentView::ApplyViewState

Ipersiststream