IEnumFORMATETC::Clone-Methode (objidl.h)
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 |
|---|---|
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der angegebene Enumerator ist ungültig. |
|
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 |