template< class T, const IID* piid, class CDV = CComDynamicUnkArray >
class IConnectionPointImpl : public _ICPLocator< piid >
Parameters
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.
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.
#include <atlcom.h>
See Also IConnectionPoint in the Win32 SDK
IConnectionPoint Methods | |
Advise | Establishes a connection between the connection point and a sink. |
EnumConnections | Creates an enumerator to iterate through the connections for the connection point. |
GetConnectionInterface | Retrieves the IID of the interface represented by the connection point. |
GetConnectionPointContainer | Retrieves the connectable object's IConnectionPointContainer interface pointer. |
Unadvise | Terminates a connection previously established through Advise. |
Data Members | |
m_vec | Manages the connections for the connection point. |
HRESULT Advise( IUnknown* pUnkSink, DWORD* pdwCookie );
See IConnectionPoint::Advise in the Win32 SDK.
Remarks
Establishes a connection between the connection point and a sink.
To terminated the connection call, Unadvise.
IConnectionPointImpl Overview | Class Members
HRESULT EnumConnections( IEnumConnections** ppEnum );
See IConnectionPoint::EnumConnections in the Win32 SDK.
Remarks
Creates an enumerator to iterate through the connections for the connection point.
IConnectionPointImpl Overview | Class Members
See Also IEnumConnections in the Win32 SDK
HRESULT GetConnectionInterface( IID* piid2 );
See IConnectionPoint::GetConnectionInterface in the Win32 SDK.
Remarks
Retrieves the IID of the interface represented by the connection point.
IConnectionPointImpl Overview | Class Members
HRESULT GetConnectionPointContainer( IConnectionPointContainer** ppCPC );
See IConnectionPoint::GetConnectionPointContainer in the Win32 SDK.
Remarks
Retrieves an interface pointer to the connectable object.
IConnectionPointImpl Overview | Class Members
See Also IConnectionPointContainerImpl
HRESULT Unadvise( DWORD dwCookie );
See IConnectionPoint::Unadvise in the Win32 SDK.
Remarks
Terminates a connection previously established through Advise.
IConnectionPointImpl Overview | Class Members
CDV m_vec;
Remarks
Manages the connections between the connection point object and a sink. By default, m_vec is of type CComDynamicUnkArray.