ITransferAdviseSink ::P ropertyFailure, méthode (shobjidl_core.h)

Appelé en cas d’échec impliquant des propriétés de fichier et qu’une interaction utilisateur est nécessaire.

Syntaxe

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

[in] psi

Pointeur vers l’objet IShellItem à l’origine de l’échec.

[in] pkey

Type : const PROPERTYKEY*

Valeur qui correspond à la propriété qui sera perdue. Une valeur NULL indique que toutes les propriétés ont été perdues.

[in] hrError

Type : HRESULT

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

Type : HRESULT

Tout autre HRESULT doit être transmis. Si l’échec n’est pas géré, la valeur de retour doit être hrError.

Code de retour	Description
COPYENGINE_S_USERRETRY	Le gestionnaire doit réessayer l’opération de fichier.
COPYENGINE_S_USERRETRYWITHNEWNAME	Le gestionnaire doit réessayer l’opération de fichier à l’aide du nom retourné dans la mémoire tampon pszRename .
COPYENGINE_S_OVERWRITE	L’utilisateur a indiqué que le gestionnaire doit remplacer le fichier existant.
COPYENGINE_S_RETRYWITHOUTSECURITY	L’utilisateur a indiqué que le gestionnaire doit réessayer l’opération sans le descripteur de sécurité.
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.

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)