ConnectToConnectionPoint, fonction (shlwapi.h)

[Cette fonction est disponible via Windows XP et Windows Server 2003. Il peut être modifié ou indisponible dans les versions ultérieures de Windows.]

Établit ou termine une connexion entre le récepteur d’un client et un conteneur de points de connexion.

Syntaxe

LWSTDAPI ConnectToConnectionPoint(
  [in, optional]  IUnknown         *punk,
  [in]            REFIID           riidEvent,
                  BOOL             fConnect,
  [in]            IUnknown         *punkTarget,
  [out]           DWORD            *pdwCookie,
  [out, optional] IConnectionPoint **ppcpOut
);

Paramètres

[in, optional] punk

Type : IUnknown*

Pointeur vers l’interface IUnknown de l’objet à connecter au conteneur de point de connexion. Si vous définissez fConnect sur FALSE pour indiquer que vous déconnectez l’objet, ce paramètre est ignoré et peut être défini sur NULL.

[in] riidEvent

Type : REFIID

IID de l’interface sur le conteneur de point de connexion dont l’objet point de connexion est demandé.

fConnect

Type : BOOL

TRUE si une connexion est en cours d’établissement ; FALSE si une connexion est interrompue.

[in] punkTarget

Type : IUnknown*

Pointeur vers l’interface IUnknown du conteneur de point de connexion.

[out] pdwCookie

Type : DWORD*

Jeton de connexion. Si vous définissez fConnect sur TRUE pour établir une nouvelle connexion, ce paramètre reçoit un jeton qui identifie la connexion de manière unique. Si vous définissez fConnect sur FALSE pour interrompre une connexion, ce paramètre doit pointer vers le jeton que vous avez reçu lorsque vous avez appelé ConnectToConnectionPoint pour établir la connexion.

[out, optional] ppcpOut

Type : IConnectionPoint**

Pointeur vers l’interface IConnectionPoint du conteneur de points de connexion, si l’opération a réussi. L’application appelante doit libérer ce pointeur lorsqu’il n’est plus nécessaire. Si la demande échoue, le pointeur reçoit NULL. Ce paramètre est facultatif et peut être NULL.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications