IEnumMoniker::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 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
E_UNEXPECTED
 Ein unerwarteter Fehler ist aufgetreten.
E_INVALIDARG
 Der angegebene Enumerator ist ungültig.
E_OUTOFMEMORY
 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

Weitere Informationen

IEnumMoniker