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 met fin à 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 points de connexion dont l’objet de point de connexion est demandé.

fConnect

Type : BOOL

TRUE si une connexion est établie ; FALSE si une connexion est interrompue.

[in] punkTarget

Type : IUnknown*

Pointeur vers l’interface IUnknown du conteneur de points 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 de manière unique la connexion. 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 point 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 requête échoue, le pointeur reçoit LA valeur 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