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

  • Artigo

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