IDispEventSimpleImpl::DispEventAdvise

Article
12/01/2015

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

Share via