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

Retorna um ponteiro para a interface IConnectionPoint de um ponto de conexão para um IID especificado, se esse IID descrever uma interface de saída com suporte.

Sintaxe

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

Parâmetros

[in] riid

Identificador de interface da interface de saída cujo objeto de ponto de conexão está sendo solicitado.

[out] ppCP

O endereço de uma variável de ponteiro de interface IConnectionPoint que recebe o ponteiro para o ponto de conexão que dá suporte à interface riid . Se ocorrer um erro, a implementação definirá o valor como NULL.

Retornar valor

Esse método pode retornar os valores retornados padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_POINTER	O endereço em ppCP não é válido. Por exemplo, pode ser NULL.
CONNECT_E_NOCONNECTION	Esse objeto conectável não dá suporte à interface de saída especificada por riid.

Comentários

Esse método é o equivalente queryInterface para as interfaces de saída de um objeto, em que a interface de saída é especificada com riid e onde o ponteiro de interface retornado é sempre o de um ponto de conexão.

Anotações aos Chamadores

Se a chamada for bem-sucedida, o chamador será responsável por liberar o ponto de conexão chamando Release quando o ponto de conexão não for mais necessário.

Observações aos implementadores

E_NOTIMPL não é permitido como um valor retornado para esse método. Qualquer implementação de IConnectionPointContainer deve implementar esse método para as interfaces de saída do objeto conectável.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	ocidl.h

Confira também

IConnectionPoint

IConnectionPointContainer