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.