Partager via


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

É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