Partager via

IFileOperationProgressSink ::P reCopyItem, méthode (shobjidl_core.h)

  • Article

Effectue des actions implémentées par l’appelant avant le début du processus de copie de chaque élément.

Syntaxe

HRESULT PreCopyItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

Paramètres

[in] dwFlags

Type : DWORD

valeur au niveau du bit qui contient des indicateurs qui contrôlent l’opération. Consultez TRANSFER_SOURCE_FLAGS pour obtenir des descriptions d’indicateur.

[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 la copie de l’élément.

[in] pszNewName

Type : LPCWSTR

Pointeur vers un nouveau nom pour l’élément après sa copie. Il s’agit d’une chaîne Unicode terminée par null et peut avoir la valeur NULL. Si la valeur est NULL, le nom de l’élément de destination est identique à celui de la source.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. En cas de valeur d’erreur, l’opération de copie et toutes les opérations suivantes en attente de l’appel à IFileOperation sont annulées.

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