| description | title | ms.date | f1_keywords | helpviewer_keywords | ms.assetid | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Learn more about: IConnectionPointImpl Class |
IConnectionPointImpl Class |
11/04/2016 |
|
|
27992115-3b86-45dd-bc9e-54f32876c557 |
This class implements a connection point.
template<class T, const IID* piid, class CDV = CComDynamicUnkArray>
class ATL_NO_VTABLE IConnectionPointImpl : public _ICPLocator<piid>
T
Your class, derived from IConnectionPointImpl.
piid
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.
| Name | Description |
|---|---|
| IConnectionPointImpl::Advise | Establishes a connection between the connection point and a sink. |
| IConnectionPointImpl::EnumConnections | Creates an enumerator to iterate through the connections for the connection point. |
| IConnectionPointImpl::GetConnectionInterface | Retrieves the IID of the interface represented by the connection point. |
| IConnectionPointImpl::GetConnectionPointContainer | Retrieves an interface pointer to the connectable object. |
| IConnectionPointImpl::Unadvise | Terminates a connection previously established through Advise. |
| Name | Description |
|---|---|
| IConnectionPointImpl::m_vec | Manages the connections for the connection point. |
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 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. Each connection is uniquely identified by a "cookie."
For more information about using connection points in ATL, see the article Connection Points.
_ICPLocator
IConnectionPointImpl
Header: atlcom.h
Establishes a connection between the connection point and a sink.
STDMETHOD(Advise)(
IUnknown* pUnkSink,
DWORD* pdwCookie);
Use Unadvise to terminate the connection call.
See IConnectionPoint::Advise in the Windows SDK.
Creates an enumerator to iterate through the connections for the connection point.
STDMETHOD(EnumConnections)(IEnumConnections** ppEnum);
See IConnectionPoint::EnumConnections in the Windows SDK.
Retrieves the IID of the interface represented by the connection point.
STDMETHOD(GetConnectionInterface)(IID* piid2);
See IConnectionPoint::GetConnectionInterface in the Windows SDK.
Retrieves an interface pointer to the connectable object.
STDMETHOD(GetConnectionPointContainer)(IConnectionPointContainer** ppCPC);
See IConnectionPoint::GetConnectionPointContainer in the Windows SDK.
Manages the connections between the connection point object and a sink.
CDV m_vec;
By default, m_vec is of type CComDynamicUnkArray.
Terminates a connection previously established through Advise.
STDMETHOD(Unadvise)(DWORD dwCookie);
See IConnectionPoint::Unadvise in the Windows SDK.