Partager via


Méthode IFileOperationProgressSink ::P reNameItem (shobjidl_core.h)

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

Syntaxe

HRESULT PreRenameItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [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 IShellItem qui spécifie l’élément à renommer.

[in] pszNewName

Type : LPCWSTR

Pointeur vers le nouveau nom complet de l’élément. Il s’agit d’une chaîne Unicode terminée par un caractère Null.

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