IEnumOleDocumentViews::Clone-Methode (docobj.h)

  • Artikel

Erstellt einen neuen Enumerator, der den gleichen Enumerationszustand wie der aktuelle Enumerator enthält.

Diese Methode ermöglicht es, einen bestimmten Punkt in der Enumerationssequenz aufzuzeichnen und dann zu einem späteren Zeitpunkt an diesen Punkt zurückzukehren. Der Aufrufer muss diese neue Aufzählung separat vom ersten Enumerationsgeber freigeben.

Syntax

HRESULT Clone(
  [out] IEnumOleDocumentViews **ppEnum
);

Parameter

[out] ppEnum

Ein Zeiger auf den IEnumOleDocumentViews-Schnittstellenzeiger auf dem neu erstellten Enumerator. Der Aufrufer muss diesen Enumerator getrennt von dem freigeben, aus dem er geklont wurde.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.
E_INVALIDARG
 Der angegebene Enumerator ist ungültig.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher für diesen Vorgang.

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

Weitere Informationen

IEnumOleDocumentViews