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

Article
08/26/2023

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 :

Appelez IFileOperation::MoveItems pour déclarer les fichiers ou dossiers sources et le dossier de destination.
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

Partager via