IDataAdviseHolder::EnumAdvise 3.Z8_K7

Returns a pointer to an IEnumStatdata interface on an enumeration object that can be used to enumerate the current advisory connections.

HRESULT EnumAdvise(

IEnumSTATDATA ** ppenumAdvise	//Indirect pointer on the new enumerator object
);

Parameter

ppenumAdvise

[out] Indirect pointer to the IEnumStatdataYCAP6P interface on the new enumerator object. If this value is NULL, there are no connections to advise sinks at this time.

Return Values

This method supports the standard return value E_OUTOFMEMORY, as well as the following:

S_OK

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

Remarks

This method must supply a pointer to an implementation of the IEnumSTATDATAYCAP6P interface, one of the standard enumerator interfaces that contain the Next, Reset, Clone, and Skip methods, on an enumerator object. Its methods allow you to enumerate the data stored in an array of STATDATA1MGEJJQ structures. You get a pointer to the OLE implementation of IDataAdviseHolder through a call to CreateDataAdviseHolderAP85R9, and then call IDataAdviseHolder::EnumAdvise to implement IDataObject::EnumDAdvise.

Adding more advisory connections while the enumerator object is active has an undefined effect on the enumeration that results from this method.