IOleDocument::EnumViews-Methode (docobj.h)
Erstellt ein -Objekt, das die von einem Dokumentobjekt unterstützten Ansichten aufzählt, oder gibt, wenn nur eine Ansicht unterstützt wird, einen Zeiger auf diese Ansicht zurück.
Syntax
HRESULT EnumViews(
[out] IEnumOleDocumentViews **ppEnum,
[out] IOleDocumentView **ppView
);
Parameter
[out] ppEnum
Ein Zeiger auf eine IEnumOleDocumentViews-Zeigervariable , die den Schnittstellenzeiger auf das Enumeratorobjekt empfängt.
[out] ppView
Ein Zeiger auf eine IOleDocumentView-Zeigervariable , die den Schnittstellenzeiger auf ein einzelnes Ansichtsobjekt empfängt.
Rückgabewert
Diese Methode gibt S_OK zurück, wenn das Objekt mehrere Sichten unterstützt, dann enthält ppEnum einen Zeiger auf das Enumeratorobjekt, und ppView ist NULL. Andernfalls ist ppEnumNULL, und ppView enthält einen Schnittstellenzeiger für die einzelne Ansicht.
Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Unzureichender Arbeitsspeicher für den Vorgang. |
|
Die Adresse in ppEnum oder ppView ist ungültig. Der Aufrufer muss gültige Zeiger für beide Argumente übergeben. |
Hinweise
Wenn ein Dokumentobjekt mehrere Sichten seiner Daten unterstützt, muss es auch IEnumOleDocumentViews implementieren und den Zeiger dieser Schnittstelle im out-Parameter ppEnum übergeben. Mithilfe dieses Zeigers kann der Container die vom Dokumentobjekt unterstützten Ansichten auflisten.
Wenn das Dokumentobjekt nur eine einzelne Ansicht unterstützt, übergibt IOleDocument::EnumViews den IOleDocumentView-Zeiger dieser Ansicht im out-Parameter ppView.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | docobj.h |