Share via


IDispEventSimpleImpl::DispEventAdvise

 

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

Syntax

      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.

Requirements

Header: atlcom.h

See Also

IDispEventSimpleImpl Class
Supporting IDispEventImpl