IEnumFsiItems::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.
Syntaxe
HRESULT Clone(
[out] IEnumFsiItems **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 |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
|
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 |