Função ConnectToConnectionPoint (shlwapi.h)

[Essa função está disponível por meio do Windows XP e do Windows Server 2003. Ele pode estar alterado ou indisponível em versões subsequentes do Windows.]

Estabelece ou encerra uma conexão entre o coletor de um cliente e um contêiner de ponto de conexão.

Sintaxe

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

Parâmetros

[in, optional] punk

Tipo: IUnknown*

Um ponteiro para a interface IUnknown do objeto a ser conectado ao contêiner do ponto de conexão. Se você definir fConnect como FALSE para indicar que está desconectando o objeto, esse parâmetro será ignorado e poderá ser definido como NULL.

[in] riidEvent

Tipo: REFIID

O IID da interface no contêiner do ponto de conexão cujo objeto de ponto de conexão está sendo solicitado.

fConnect

Tipo: BOOL

TRUE se uma conexão estiver sendo estabelecida; FALSE se uma conexão estiver sendo interrompida.

[in] punkTarget

Tipo: IUnknown*

Um ponteiro para a interface IUnknown do contêiner do ponto de conexão.

[out] pdwCookie

Tipo: DWORD*

Um token de conexão. Se você definir fConnect como TRUE para fazer uma nova conexão, esse parâmetro receberá um token que identifica exclusivamente a conexão. Se você definir fConnect como FALSE para interromper uma conexão, esse parâmetro deverá apontar para o token que você recebeu quando chamou ConnectToConnectionPoint para estabelecer a conexão.

[out, optional] ppcpOut

Tipo: IConnectionPoint**

Um ponteiro para a interface IConnectionPoint do contêiner do ponto de conexão, se a operação foi bem-sucedida. O aplicativo de chamada deve liberar esse ponteiro quando ele não for mais necessário. Se a solicitação não for bem-sucedida, o ponteiro receberá NULL. Esse parâmetro é opcional e pode ser NULL.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
DLL	Shlwapi.dll (versão 5.0 ou posterior)