IEnumFORMATETC::Clone-Methode (objidl.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] IEnumFORMATETC **ppenum
);

Parameter

[out] ppenum

Adresse einer IEnumFORMATETC-Zeigervariable , die den Schnittstellenzeiger auf das Enumerationsobjekt empfängt. Wenn die Methode nicht erfolgreich ist, wird der Wert dieser Ausgabevariable nicht definiert.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

IEnumFORMATETC