IFileOperation ::CopyItems, méthode (shobjidl_core.h)

  • Article

Déclare un ensemble d’éléments qui doivent être copiés vers une destination spécifiée.

Syntaxe

HRESULT CopyItems(
  [in] IUnknown   *punkItems,
  [in] IShellItem *psiDestinationFolder
);

Paramètres

[in] punkItems

Type : IUnknown*

Pointeur vers le IUnknown de l’objet IShellItemArray, IDataObject ou IEnumShellItems qui représente le groupe d’éléments à copier. Vous pouvez également pointer vers un objet IPersistIDList pour représenter un élément unique, en accomplissant efficacement la même fonction que IFileOperation ::CopyItem.

[in] psiDestinationFolder

Type : IShellItem*

Pointeur vers un IShellItem qui spécifie le dossier de destination à contenir la copie des éléments.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode ne copie pas les éléments, mais déclare simplement les éléments à copier. Pour copier un groupe d’éléments, vous devez effectuer au moins la séquence d’appels détaillée ici :

  1. Appelez IFileOperation ::CopyItems pour déclarer les éléments sources et le dossier de destination.
  2. Appelez IFileOperation ::P erformOperations pour commencer l’opération de copie.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)

Voir aussi

IFileOperation

IFileOperation ::CopyItem