Partilhar via

Classe IConnectionPointImpl

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe implementa um ponto de ligação.

Sintaxe

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

Parâmetros

T
A sua classe, derivada de IConnectionPointImpl.

Piid
Um ponteiro para o IID da interface representado pelo objeto ponto de ligação.

CDV
Uma classe que gere as ligações. O valor padrão é CComDynamicUnkArray, que permite ligações ilimitadas. Também pode usar o CComUnkArray, que especifica um número fixo de ligações.

Membros

Métodos Públicos

Nome Description
IConnectionPointImpl::Aconselhar Estabelece uma ligação entre o ponto de ligação e um sumidouro.
IConnectionPointImpl::EnumConnections Cria um enumerador para iterar pelas ligações do ponto de ligação.
IConnectionPointImpl::GetConnectionInterface Recupera o IID da interface representada pelo ponto de ligação.
IConnectionPointImpl::GetConnectionPointContainer Recupera um ponteiro de interface para o objeto conectável.
IConnectionPointImpl::Desaconselhado Termina uma ligação previamente estabelecida através Advisede .

Membros de Dados Públicos

Nome Description
IConnectionPointImpl::m_vec Gere as ligações do ponto de ligação.

Observações

IConnectionPointImpl implementa um ponto de ligação, que permite a um objeto expor uma interface de saída ao cliente. O cliente implementa esta interface num objeto chamado sumidouro.

O ATL utiliza o IConnectionPointContainerImpl para implementar o objeto conectável. Cada ponto de ligação dentro do objeto conectável representa uma interface de saída, identificada por PIID. A classe CDV gere as ligações entre o ponto de ligação e um sumidouro. Cada ligação é identificada de forma única por um "cookie".

Para mais informações sobre o uso de pontos de ligação em ATL, consulte o artigo Pontos de Ligação.

Hierarquia de herança

_ICPLocator

IConnectionPointImpl

Requerimentos

Cabeçalho: atlcom.h

IConnectionPointImpl::Aconselhar

Estabelece uma ligação entre o ponto de ligação e um sumidouro.

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

Observações

Use Unadvise para terminar a chamada de ligação.

Veja IConnectionPoint::Advise no SDK do Windows.

IConnectionPointImpl::EnumConnections

Cria um enumerador para iterar pelas ligações do ponto de ligação.

STDMETHOD(EnumConnections)(IEnumConnections** ppEnum);

Observações

Veja IConnectionPoint::EnumConnections no SDK do Windows.

IConnectionPointImpl::GetConnectionInterface

Recupera o IID da interface representada pelo ponto de ligação.

STDMETHOD(GetConnectionInterface)(IID* piid2);

Observações

Veja IConnectionPoint::GetConnectionInterface no SDK do Windows.

IConnectionPointImpl::GetConnectionPointContainer

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

STDMETHOD(GetConnectionPointContainer)(IConnectionPointContainer** ppCPC);

Observações

Veja IConnectionPoint::GetConnectionPointContainer no Windows SDK.

IConnectionPointImpl::m_vec

Gere as ligações entre o objeto ponto de ligação e um sumidouro.

CDV m_vec;

Observações

Por defeito, m_vec é do tipo CComDynamicUnkArray.

IConnectionPointImpl::Desaconselhado

Termina uma ligação previamente estabelecida através do Advise.

STDMETHOD(Unadvise)(DWORD dwCookie);

Observações

Veja IConnectionPoint::Unadvise no SDK do Windows.

Consulte também

IConnectionPoint
Visão geral da classe

  • Last updated on