IDataObject::EnumDAdvise method

Creates an object that can be used to enumerate the current advisory connections.

Syntax

HRESULT EnumDAdvise(
  IEnumSTATDATA **ppenumAdvise
);

Parameters

ppenumAdvise

A pointer to an IEnumSTATDATA pointer variable that receives the interface pointer to the new enumerator object. If the implementation sets *ppenumAdvise to NULL, there are no connections to advise sinks at this time.

Return Value

This method returns S_OK if the enumerator object is successfully instantiated or there are no connections. Other possible values include the following.

Return code Description
E_OUTOFMEMORY
Insufficient memory is available for the operation.
OLE_E_ADVISENOTSUPPORTED
Advisory notifications are not supported by this object.

Remarks

The enumerator object created by this method implements the IEnumSTATDATA interface. IEnumSTATDATA permits the enumeration of the data stored in an array of STATDATA structures. Each of these structures provides information on a single advisory connection, and includes FORMATETC and ADVF information, as well as the pointer to the advise sink and the token representing the connection.

Notes to Callers

It is recommended that you use the OLE data advise holder object to handle advisory connections. With the pointer obtained through a call to CreateDataAdviseHolder, implementing IDataObject::EnumDAdvise becomes a simple matter of delegating the call to IDataAdviseHolder::EnumAdvise. This creates the enumerator and supplies the pointer to the OLE implementation of IEnumSTATDATA. At that point, you can call its methods to enumerate the current advisory connections.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header objidl.h

See Also

IDataAdviseHolder::EnumAdvise

IDataObject

IEnumSTATDATA