Funzione ConnectToConnectionPoint (shlwapi.h)

[Questa funzione è disponibile tramite Windows XP e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Stabilisce o termina una connessione tra il sink di un client e un contenitore di punti di connessione.

Sintassi

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

Parametri

[in, optional] punk

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown dell'oggetto da connettere al contenitore del punto di connessione. Se si imposta fConnect su FALSE per indicare che si sta disconnettendo l'oggetto, questo parametro viene ignorato e può essere impostato su NULL.

[in] riidEvent

Tipo: REFIID

IID dell'interfaccia nel contenitore del punto di connessione di cui viene richiesto l'oggetto punto di connessione.

fConnect

Tipo: BOOL

TRUE se viene stabilita una connessione; FALSE se una connessione viene interrotta.

[in] punkTarget

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown del contenitore del punto di connessione.

[out] pdwCookie

Tipo: DWORD*

Token di connessione. Se si imposta fConnect su TRUE per stabilire una nuova connessione, questo parametro riceve un token che identifica in modo univoco la connessione. Se si imposta fConnect su FALSE per interrompere una connessione, questo parametro deve puntare al token ricevuto quando si chiama ConnectToConnectionPoint per stabilire la connessione.

[out, optional] ppcpOut

Tipo: IConnectionPoint**

Puntatore all'interfaccia IConnectionPoint del contenitore del punto di connessione, se l'operazione ha avuto esito positivo. L'applicazione chiamante deve rilasciare questo puntatore quando non è più necessario. Se la richiesta ha esito negativo, il puntatore riceve NULL. Questo parametro è facoltativo e può essere NULL.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server, Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
DLL	Shlwapi.dll (versione 5.0 o successiva)