Méthode IFileOperation::MoveItems (shobjidl_core.h)

  • Article

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

Syntaxe

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

Paramètres

[in] punkItems

Type : IUnknown*

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

[in] psiDestinationFolder

Type : IShellItem*

Pointeur vers un objet IShellItem qui spécifie le dossier de destination à contenir les éléments déplacés.

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 déplace pas les éléments, elle déclare simplement les éléments à déplacer. Pour déplacer un groupe d’éléments, vous devez effectuer au moins la séquence d’appels détaillée ici :

  1. Appelez IFileOperation::MoveItems pour déclarer les fichiers ou dossiers sources et le dossier de destination.
  2. Appelez IFileOperation::P erformOperations pour commencer l’opération de déplacement.

Configuration requise

   
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 (inclure Shobjidl.h)

Voir aussi

IFileOperation

IFileOperation::MoveItem