Класс ИконнектионпоинтимплIConnectionPointImpl Class

• 11/04/2016
• Чтение занимает 2 мин
• • T
  • o
  • O

Этот класс реализует точку соединения.This class implements a connection point.

СинтаксисSyntax

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

ПараметрыParameters

TT
Класс, производный от IConnectionPointImpl .Your class, derived from IConnectionPointImpl.

пиидpiid
Указатель на идентификатор IID интерфейса, представленного объектом точки подключения.A pointer to the IID of the interface represented by the connection point object.

кдвCDV
Класс, управляющий соединениями.A class that manages the connections. Значение по умолчанию — ккомдинамикункаррай, что позволяет устанавливать неограниченное число подключений.The default value is CComDynamicUnkArray, which allows unlimited connections. Можно также использовать ккомункаррай, который указывает фиксированное число соединений.You can also use CComUnkArray, which specifies a fixed number of connections.

ЭлементыMembers

Открытые методыPublic Methods

Открытые члены данныхPublic Data Members

КомментарииRemarks

IConnectionPointImpl реализует точку подключения, которая позволяет объекту предоставлять клиенту исходящий интерфейс.IConnectionPointImpl implements a connection point, which allows an object to expose an outgoing interface to the client. Клиент реализует этот интерфейс для объекта, называемого приемником.The client implements this interface on an object called a sink.

ATL использует иконнектионпоинтконтаинеримпл для реализации объекта, доступного для соединения.ATL uses IConnectionPointContainerImpl to implement the connectable object. Каждая точка подключения в подключаемом объекте представляет исходящий интерфейс, идентифицируемый пиид.Each connection point within the connectable object represents an outgoing interface, identified by piid. Класс КДВ управляет соединениями между точкой подключения и приемником.Class CDV manages the connections between the connection point and a sink. Каждое соединение однозначно идентифицируется с помощью "cookie".Each connection is uniquely identified by a "cookie."

Дополнительные сведения об использовании точек подключения в ATL см. в статье точки подключения.For more information about using connection points in ATL, see the article Connection Points.

Иерархия наследованияInheritance Hierarchy

_ICPLocator

IConnectionPointImpl

ТребованияRequirements

Заголовок: атлком. hHeader: atlcom.h

Иконнектионпоинтимпл:: AdviseIConnectionPointImpl::Advise

Устанавливает соединение между точкой подключения и приемником.Establishes a connection between the connection point and a sink.

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

КомментарииRemarks

Чтобы завершить вызов соединения, используйте параметр unadvise .Use Unadvise to terminate the connection call.

См. раздел IConnectionPoint:: Advise в Windows SDK.See IConnectionPoint::Advise in the Windows SDK.

Иконнектионпоинтимпл:: ЕнумконнектионсIConnectionPointImpl::EnumConnections

Создает перечислитель для прохода по соединениям для точки подключения.Creates an enumerator to iterate through the connections for the connection point.

STDMETHOD(EnumConnections)(IEnumConnections** ppEnum);

КомментарииRemarks

См. раздел IConnectionPoint:: енумконнектионс в Windows SDK.See IConnectionPoint::EnumConnections in the Windows SDK.

Иконнектионпоинтимпл:: ЖетконнектионинтерфацеIConnectionPointImpl::GetConnectionInterface

Возвращает идентификатор IID интерфейса, представленного точкой подключения.Retrieves the IID of the interface represented by the connection point.

STDMETHOD(GetConnectionInterface)(IID* piid2);

КомментарииRemarks

См. раздел IConnectionPoint:: жетконнектионинтерфаце в Windows SDK.See IConnectionPoint::GetConnectionInterface in the Windows SDK.

Иконнектионпоинтимпл:: ЖетконнектионпоинтконтаинерIConnectionPointImpl::GetConnectionPointContainer

Извлекает указатель интерфейса на объект, который можно подключить.Retrieves an interface pointer to the connectable object.

STDMETHOD(GetConnectionPointContainer)(IConnectionPointContainer** ppCPC);

КомментарииRemarks

См. раздел IConnectionPoint:: жетконнектионпоинтконтаинер в Windows SDK.See IConnectionPoint::GetConnectionPointContainer in the Windows SDK.

Иконнектионпоинтимпл:: m_vecIConnectionPointImpl::m_vec

Управляет соединениями между объектом точки подключения и приемником.Manages the connections between the connection point object and a sink.

CDV m_vec;

КомментарииRemarks

По умолчанию m_vec имеет тип ккомдинамикункаррай.By default, m_vec is of type CComDynamicUnkArray.

Иконнектионпоинтимпл:: unadviseIConnectionPointImpl::Unadvise

Завершает подключение, установленное ранее с помощью advise.Terminates a connection previously established through Advise.

STDMETHOD(Unadvise)(DWORD dwCookie);

КомментарииRemarks

См. раздел IConnectionPoint:: unadvise в Windows SDK.See IConnectionPoint::Unadvise in the Windows SDK.

См. также разделSee also

IConnectionPointIConnectionPoint
Общие сведения о классахClass Overview