Método IOleDocument::EnumViews (docobj.h)

Cria um objeto que enumera as exibições compatíveis com um objeto de documento ou, se apenas uma exibição tiver suporte, retorna um ponteiro para essa exibição.

Sintaxe

HRESULT EnumViews(
  [out] IEnumOleDocumentViews **ppEnum,
  [out] IOleDocumentView      **ppView
);

Parâmetros

[out] ppEnum

Um ponteiro para uma variável de ponteiro IEnumOleDocumentViews que recebe o ponteiro de interface para o objeto enumerador.

[out] ppView

Um ponteiro para uma variável de ponteiro IOleDocumentView que recebe o ponteiro de interface para um único objeto de exibição.

Valor retornado

Esse método retornará S_OK se o objeto der suporte a várias exibições, ppEnum conterá um ponteiro para o objeto enumerador e ppView for NULL. Caso contrário, ppEnum será NULL e ppView conterá um ponteiro de interface na exibição única.

Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_OUTOFMEMORY	Memória insuficiente disponível para a operação.
E_POINTER	O endereço em ppEnum ou ppView é inválido. O chamador deve passar ponteiros válidos para ambos os argumentos.

Comentários

Se um objeto de documento der suporte a várias exibições de seus dados, ele também deverá implementar IEnumOleDocumentViews e passar o ponteiro dessa interface no parâmetro out ppEnum. Usando esse ponteiro, o contêiner pode enumerar as exibições compatíveis com o objeto do documento.

Se o objeto de documento der suporte apenas a uma única exibição, IOleDocument::EnumViews passará o ponteiro IOleDocumentView desse modo de exibição no parâmetro out ppView.

Requisitos

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

IEnumOleDocumentViews

Ioledocument

Ioledocumentview