IEnumProgressItems::Clone, méthode (imapi2fs.h)
Crée un autre énumérateur qui contient le même état d’énumération que l’énumérateur actuel.
HRESULT Clone(
[out] IEnumProgressItems **ppEnum
);
[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é.
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 |
---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
Impossible d’allouer la mémoire requise.
Valeur : 0x8007000E |
À 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.
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 |