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

Article
03/06/2024

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 :

Appelez IFileOperation ::CopyItems pour déclarer les éléments sources et le dossier de destination.
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

Partager via