IDispEventSimpleImpl::DispEventAdvise (ATL)

Switch View :
ScriptFree
ATL Library Reference
IDispEventSimpleImpl::DispEventAdvise

Call this method to establish a connection with the event source represented by pUnk.

HRESULT DispEventAdvise(
   IUnknown* pUnk 
   const IID* piid 
);

Parameters

pUnk
[in] A pointer to the IUnknown interface of the event source object.
piid
A pointer to the IID of the event source object.

Return Value

S_OK or any failure HRESULT value.

Remarks

Subsequently, events fired from pUnk will be routed to handlers in your class by way of the event sink map.

Note   If your class derives from multiple IDispEventSimpleImpl classes, you will need to disambiguate calls to this method by scoping the call with the particular base class you are interested in.

DispEventAdvise establishes a connection with the event source specified in pdiid.

See Also

IDispEventSimpleImpl Overview | Class Members | Supporting IDispEventImpl