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

Article
08/26/2023

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 l’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 ITransferSource::Unadvise . Si la connexion n’a pas été é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 ITransferSource::Advise avant d’appeler d’autres méthodes dans cette interface pour activer une session de conseil. S’il n’est pas défini, le gestionnaire doit le considérer comme une indication qu’aucun commentaire n’est disponible et d’effectuer l’opération « par défaut » sans consulter l’application appelante.

Configuration requise


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