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

  • Article

Déclare un seul élément qui doit être déplacé vers une destination spécifiée.

Syntaxe

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Paramètres

[in] psiItem

Type : IShellItem*

Pointeur vers un objet IShellItem qui spécifie l’élément source.

[in] psiDestinationFolder

Type : IShellItem*

Pointeur vers un objet IShellItem qui spécifie le dossier de destination à contenir l’élément déplacé.

[in] pszNewName

Type : LPCWSTR

Pointeur vers un nouveau nom pour l’élément dans son nouvel emplacement. Il s’agit d’une chaîne Unicode terminée par null et peut être NULL. Si la valeur est NULL, le nom de l’élément de destination est le même que celui de la source.

[in] pfopsItem

Type : IFileOperationProgressSink*

Pointeur vers un objet IFileOperationProgressSink à utiliser pour la progression status et les notifications d’erreur pour cette opération de déplacement spécifique. Si vous appelez IFileOperation ::Advise pour l’opération globale, la progression status et les notifications d’erreur pour l’opération de déplacement y sont incluses. Par conséquent, définissez ce paramètre sur NULL.

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 l’élément, mais déclare simplement l’élément à déplacer. Pour déplacer un objet, vous devez effectuer au moins la séquence d’appels détaillée ici :

  1. Appelez IFileOperation ::MoveItem pour déclarer l’élément source, le dossier de destination et le nom de destination.
  2. Appelez IFileOperation ::P erformOperations pour commencer l’opération de déplacement.

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 ::MoveItems

PostMoveItem

PreMoveItem