IDataObject::EnumDAdvise

Returns an object to enumerate the current advisory connections.

HRESULT EnumDAdvise(

IEnumSTATDATA ** ppenumAdvise	//Location for IEnumSTATDATA
);

Parameter
ppenumAdvise

[out]Points to the location where the new enumerator object should be returned. If the returned value is NULL, there are no connections to advise sinks at this time.

Return Values
S_OK

The enumerator object is successfully instantiated or there are no connections.

E_OUTOFMEMORY

The enumerator object could not be instantiated due to lack of memory.

OLE_E_ADVISENOTSUPPORTED

Advisory notifications are not supported by this object.

Comments
The enumerator object returned by this method implements the IEnumSTATDATA interface, one of the standard enumerator interfaces that contain the Next, Reset, Clone, and Skip methods. IEnumSTATDATA enumerates the data stored in an array of STATDATA structures.

While this enumeration is in progress, the effect of adding more advisory connections on the subsequent enumeration is undefined.