Compartilhar via


Classe IConnectionPointImpl

Essa classe implementa um ponto de conexão.

Sintaxe

template<class T, const IID* piid, class CDV = CComDynamicUnkArray>
class ATL_NO_VTABLE IConnectionPointImpl : public _ICPLocator<piid>

Parâmetros

T
Sua classe, derivada de IConnectionPointImpl.

piid
Um ponteiro para o IID da interface representada pelo objeto de ponto de conexão.

CDV
Uma classe que gerencia as conexões. O valor padrão é CComDynamicUnkArray, que permite conexões ilimitadas. Você também pode usar CComUnkArray, que especifica um número fixo de conexões.

Membros

Métodos públicos

Nome Descrição
IConnectionPointImpl::Advise Estabelece uma conexão entre um ponto de conexão e um coletor.
IConnectionPointImpl::EnumConnections Cria um enumerador para iterar por meio das conexões do ponto de conexão.
IConnectionPointImpl::GetConnectionInterface Recupera a IID da interface representada pelo ponto de conexão.
IConnectionPointImpl::GetConnectionPointContainer Recupera um ponteiro de interface para o objeto conectável.
IConnectionPointImpl::Unadvise Encerra uma conexão estabelecida anteriormente por meio de Advise.

Membros de Dados Públicos

Nome Descrição
IConnectionPointImpl::m_vec Gerencia as conexões do ponto de conexão.

Comentários

IConnectionPointImpl implementa um ponto de conexão, que permite que um objeto exponha uma interface de saída ao cliente. O cliente implementa essa interface em um objeto chamado coletor.

A ATL usa IConnectionPointContainerImpl para implementar o objeto conectável. Cada ponto de conexão dentro do objeto conectável representa uma interface de saída, identificada por piid. A classe CDV gerencia as conexões entre o ponto de conexão e um coletor. Cada conexão é identificada exclusivamente por um "cookie".

Para obter mais informações sobre o uso de pontos de conexão na ATL, consulte o artigo Pontos de Conexão.

Hierarquia de herança

_ICPLocator

IConnectionPointImpl

Requisitos

Cabeçalho: atlcom.h

IConnectionPointImpl::Advise

Estabelece uma conexão entre um ponto de conexão e um coletor.

STDMETHOD(Advise)(
    IUnknown* pUnkSink,
    DWORD* pdwCookie);

Comentários

Para encerrar a conexão, chame DUnadvise.

Consulte IConnectionPoint::Aconselhar no SDK do Windows.

IConnectionPointImpl::EnumConnections

Cria um enumerador para iterar por meio das conexões do ponto de conexão.

STDMETHOD(EnumConnections)(IEnumConnections** ppEnum);

Comentários

Consulte IConnectionPoint::EnumConnections no SDK do Windows.

IConnectionPointImpl::GetConnectionInterface

Recupera a IID da interface representada pelo ponto de conexão.

STDMETHOD(GetConnectionInterface)(IID* piid2);

Comentários

Consulte IConnectionPoint::GetConnectionInterface no SDK do Windows.

IConnectionPointImpl::GetConnectionPointContainer

Recupera um ponteiro de interface para o objeto conectável.

STDMETHOD(GetConnectionPointContainer)(IConnectionPointContainer** ppCPC);

Comentários

Confira IConnectionPoint::GetConnectionPointContainer no SDK do Windows.

IConnectionPointImpl::m_vec

Gerencia as conexões entre o objeto de ponto de conexão e um coletor.

CDV m_vec;

Comentários

Por padrão, m_vec é do tipo CComDynamicUnkArray.

IConnectionPointImpl::Unadvise

Encerra uma conexão estabelecida anteriormente por meio de Advise.

STDMETHOD(Unadvise)(DWORD dwCookie);

Comentários

Consulte IConnectionPoint::Unadvise no SDK do Windows.

Confira também

Ponto de conexão
Visão geral da aula