IEnumProgressItems::Clone, méthode (imapi2fs.h)

Article
08/24/2023

Crée un autre énumérateur qui contient le même état d’énumération que l’énumérateur actuel.

Syntaxe

HRESULT Clone(
  [out] IEnumProgressItems **ppEnum
);

Paramètres

[out] ppEnum

Reçoit le pointeur d’interface vers l’objet énumération. Si la méthode échoue, la valeur de cette variable de sortie n’est pas définie. Vous devez libérer ppEnum lorsque vous avez terminé.

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour	Description
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
E_OUTOFMEMORY	Impossible d’allouer la mémoire requise. Valeur : 0x8007000E

Notes

À l’aide de cette méthode, un client peut enregistrer un point particulier dans la séquence d’énumération, puis revenir à ce point ultérieurement. Le nouvel énumérateur prend en charge la même interface que l’interface d’origine.

Configuration requise


Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi2fs.h

Voir aussi

IEnumProgressItems

IProgressItems

Partager via