Méthode IConnectionPoint ::Advise (ocidl.h)

Article
02/29/2024

Établit une connexion entre un objet de point de connexion et le récepteur du client.

Syntaxe

HRESULT Advise(
  [in]  IUnknown *pUnkSink,
  [out] DWORD    *pdwCookie
);

Paramètres

[in] pUnkSink

Pointeur vers l’interface IUnknown sur le récepteur de conseil du client. Le récepteur du client reçoit les appels sortants du point de connexion.

[out] pdwCookie

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

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	La connexion a été établie et *pdwCookie a le jeton de connexion.
E_POINTER	La valeur dans pUnkSink ou pdwCookie n’est pas valide. Par exemple, l’un ou l’autre pointeur peut avoir la valeur NULL.
CONNECT_E_ADVISELIMIT	Le point de connexion a déjà atteint sa limite de connexions et ne peut plus en accepter.
CONNECT_E_CANNOTCONNECT	Le récepteur ne prend pas en charge l’interface requise par ce point de connexion.

Remarques

Conseille établit une connexion entre le point de connexion et le récepteur de l’appelant identifié avec pUnkSink.

Le point de connexion doit appeler QueryInterface pour obtenir le pointeur d’interface sortant correct à appeler lorsque des événements se produisent, avec l’IID pour l’interface sortante gérée par le point de connexion. Lorsque l’IID est passé à la méthode IConnectionPointContainer ::FindConnectionPoint , un pointeur d’interface vers ce même point de connexion est retourné.

Remarques aux implémenteurs

Le point de connexion doit interroger le pointeur pUnkSink pour obtenir l’interface sortante correcte. Si cette requête échoue, cette méthode doit retourner CONNECT_E_CANNOTCONNECT.

La valeur pdwCookie doit être unique pour chaque connexion à une instance donnée d’un point de connexion.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IConnectionPoint

Partager via