IEnumProgressItems::Clone-Methode (imapi2fs.h)
Erstellt einen weiteren Enumerator, der den gleichen Enumerationszustand wie der aktuelle Enumerator enthält.
Syntax
HRESULT Clone(
[out] IEnumProgressItems **ppEnum
);
Parameter
[out] ppEnum
Empfängt den Schnittstellenzeiger auf das Enumerationsobjekt. Wenn die Methode nicht erfolgreich ist, wird der Wert dieser Ausgabevariable nicht definiert. Sie müssen ppEnum freigeben, wenn Sie fertig sind.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
Hinweise
Mit dieser Methode kann ein Client einen bestimmten Punkt in der Enumerationssequenz aufzeichnen und dann zu einem späteren Zeitpunkt zu diesem Punkt zurückkehren. Der neue Enumerator unterstützt dieselbe Schnittstelle wie die ursprüngliche.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2fs.h |