IOpcPartEnumerator::Clone-Methode (msopc.h)

Artikel
02/29/2024

Erstellt eine Kopie des aktuellen Enumerators und aller untergeordneten Elemente.

Syntax

HRESULT Clone(
  [out, retval] IOpcPartEnumerator **copy
);

Parameter

[out, retval] copy

Ein Zeiger auf die IOpcPartEnumerator-Schnittstelle des neuen Enumerators.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der Copy-Parameter ist NULL.
OPC_E_ENUM_COLLECTION_CHANGED 0x80510050	Der Enumerator ist ungültig, da sich der zugrunde liegende Satz geändert hat.

Hinweise

Wenn ein Enumerator erstellt wird, geht die aktuelle Position dem ersten Zeiger voran. Um die aktuelle Position auf den ersten Zeiger des Enumerators festzulegen, rufen Sie nach dem Erstellen des Enumerators die MoveNext-Methode auf.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h