Partager via

Méthode ITransferAdviseSink ::FileFailure (shobjidl_core.h)

  • Article

Appelé en cas d’échec et qu’une interaction utilisateur est nécessaire.

Syntaxe

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

Paramètres

[in] psi

Type : IShellItem*

IShellItem sur lequel l’opération a échoué.

[in] pszItem

Type : LPCWSTR

facultatif. Pointeur vers une mémoire tampon terminée par null qui contient le nom du fichier. Si cette valeur est NULL, le nom donné par le paramètre psi est utilisé.

[in] hrError

Type : HRESULT

Code d’erreur généré par l’échec. Cette erreur doit être gérée par le moteur de copie.

[in, out] pszRename

Type : LPWSTR

facultatif. Lorsque cette méthode retourne, contient un pointeur vers une mémoire tampon terminée par null qui contient un nouveau nom pour le fichier. Le nom ne peut pas dépasser la longueur cchRename. Si ce paramètre a la valeur NULL, aucune option à renommer n’est disponible.

[in] cchRename

Type : ULONG

Taille de la mémoire tampon pszRename , en caractères.

Valeur retournée

Type : HRESULT

Tout autre HRESULT doit être retourné au processus d’appel. Si l’échec n’est pas géré, la valeur de retour doit être hrError.

Code de retour Description
COPYENGINE_S_USER_RETRY
 L’utilisateur a cliqué sur Réessayer. Le gestionnaire doit réessayer l’opération de fichier.
COPYENGINE_E_USERCANCELLED
 L’utilisateur a cliqué sur Annuler. L’ensemble du travail de copie est en cours d’arrêt. Le gestionnaire doit renvoyer ce code au moteur de copie.
COPYENGINE_S_USER_IGNORED
 L’utilisateur a cliqué sur Ignorer. Le gestionnaire doit ignorer la création de l’élément et renvoyer ce code au moteur de copie.

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)