Metodo IOleDocument::EnumViews (docobj.h)

Crea un oggetto che enumera le visualizzazioni supportate da un oggetto documento o, se è supportata una sola visualizzazione, restituisce un puntatore a tale visualizzazione.

Sintassi

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

Parametri

[out] ppEnum

Puntatore a una variabile puntatore IEnumOleDocumentViews che riceve il puntatore di interfaccia all'oggetto enumeratore.

[out] ppView

Puntatore a una variabile puntatore IOleDocumentView che riceve il puntatore dell'interfaccia a un singolo oggetto visualizzazione.

Valore restituito

Questo metodo restituisce S_OK se l'oggetto supporta più visualizzazioni, ppEnum contiene un puntatore all'oggetto enumeratore e ppView è NULL. In caso contrario, ppEnum è NULL e ppView contiene un puntatore all'interfaccia nella singola visualizzazione.

Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente disponibile per l'operazione.
E_POINTER	L'indirizzo in ppEnum o ppView non è valido. Il chiamante deve passare puntatori validi per entrambi gli argomenti.

Commenti

Se un oggetto documento supporta più visualizzazioni dei dati, deve implementare anche IEnumOleDocumentViews e passare il puntatore dell'interfaccia nel parametro out ppEnum. Usando questo puntatore, il contenitore può enumerare le visualizzazioni supportate dall'oggetto documento.

Se l'oggetto documento supporta una sola visualizzazione, IOleDocument::EnumViews passa il puntatore IOleDocumentView della visualizzazione nel parametro out ppView.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	docobj.h

Vedi anche

IEnumOleDocumentViews

IOleDocument

IOleDocumentView