IEnumMoniker::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 zu einem späteren Zeitpunkt zu diesem Punkt zurückzukehren. Der Aufrufer muss diese neue Aufzählung separat vom ersten Enumerationsgeber freigeben.
Syntax
HRESULT Clone(
[out] IEnumMoniker **ppenum
);
Parameter
[out] ppenum
Adresse einer IEnumMoniker-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. |
|
Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |