Méthode IConnectionPointContainer ::FindConnectionPoint (ocidl.h)

Article
03/04/2024

Retourne un pointeur vers l’interface IConnectionPoint d’un point de connexion pour un IID spécifié, si celui-ci décrit une interface sortante prise en charge.

Syntaxe

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

Paramètres

[in] riid

Identificateur d’interface de l’interface sortante dont l’objet de point de connexion est demandé.

[out] ppCP

Adresse d’une variable pointeur d’interface IConnectionPoint qui reçoit le pointeur vers le point de connexion qui prend en charge l’interface riid . Si une erreur se produit, l’implémentation définit la valeur sur NULL.

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 commande s'est correctement terminée.
E_POINTER	L’adresse dans ppCP n’est pas valide. Par exemple, il peut s’agir de NULL.
CONNECT_E_NOCONNECTION	Cet objet connectable ne prend pas en charge l’interface sortante spécifiée par riid.

Remarques

Cette méthode est l’équivalent QueryInterface pour les interfaces sortantes d’un objet, où l’interface sortante est spécifiée avec riid et où le pointeur d’interface retourné est toujours celui d’un point de connexion.

Remarques aux appelants

Si l’appel réussit, l’appelant est chargé de libérer le point de connexion en appelant Release lorsque le point de connexion n’est plus nécessaire.

Remarques aux implémenteurs

E_NOTIMPL n’est pas autorisé comme valeur de retour pour cette méthode. Toute implémentation d’IConnectionPointContainer doit implémenter cette méthode pour les interfaces sortantes de l’objet connectable.

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

IConnectionPointContainer

Partager via