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

  • Artigo

Cria um objeto enumerador para iterar todos os pontos de conexão com suporte no objeto conectável, um ponto de conexão por IID de saída.

Sintaxe

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

Parâmetros

[out] ppEnum

Um ponteiro para uma variável de ponteiro de interface IEnumConnectionPoints que recebe o ponteiro para o enumerador recém-criado.

Retornar valor

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

Código de retorno Descrição
S_OK
 O objeto enumerador foi criado com êxito.
E_POINTER
 O endereço em ppEnum não é válido. Por exemplo, pode ser NULL.

Comentários

Como IEnumConnectionPoints enumera ponteiros para IConnectionPoint, o chamador deve usar IConnectionPoint::GetConnectionInterface para determinar o identificador de interface da interface de saída compatível com o ponto de conexão.

Anotações para chamadores

O chamador é responsável por chamar Release quando o enumerador não é mais necessário.

Anotações aos implementadores

Retornar E_NOTIMPL é especificamente não permitido porque, com exceção das informações de tipo, não haveria outros meios pelos quais um chamador poderia encontrar os IIDs das interfaces de saída. Como um objeto conectável normalmente tem um conjunto fixo de interfaces de saída conhecidas, é simples implementar o enumerador sobre uma matriz de comprimento fixo de IIDs conhecida em tempo de compilação.

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

IConnectionPointContainer

Ienumconnectionpoints