Méthode ITransferDestination ::Advise (shobjidl_core.h)

Article
03/04/2024

Configure une connexion de conseil pour les notifications sur le status des opérations de fichier.

Syntaxe

HRESULT Advise(
  [in]  ITransferAdviseSink *psink,
  [out] DWORD               *pdwCookie
);

Paramètres

[in] psink

Type : ITransferAdviseSink*

Pointeur vers une interface de notification ITransferAdviseSink pour mettre à jour l’application appelante à l’aide de méthodes sur cette interface.

[out] pdwCookie

Type : DWORD*

Pointeur vers un jeton retourné qui identifie de manière unique cette connexion. L’application appelante utilise ce jeton ultérieurement pour supprimer la connexion en le transmettant à la méthode ITransferDestination ::Unadvise . Si la connexion n’est pas établie, cette valeur est égale à zéro.

Valeur retournée

Type : HRESULT

Tous les HRESULT autres que ceux répertoriés indiquent un échec.

Code de retour	Description
S_OK	Interface correctement associée.
E_UNEXPECTED	Le gestionnaire ne peut gérer qu’une seule interface récepteur.

Remarques

Appelez ITransferDestination ::Conseiller avant d’appeler d’autres méthodes ITransferDestination afin que le gestionnaire puisse rappeler toutes les erreurs qui peuvent se produire. S’il n’est pas défini, le gestionnaire doit le considérer comme une indication qu’aucun commentaire n’est disponible et effectuer l’opération « par défaut ».

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)

Partager via