IOleAdviseHolder::EnumAdvise

Enumerates the advisory connections currently established for an object.

HRESULT EnumAdvise(

IEnumSTATDATA ** ppenumAdvise	//A pointer to a pointer to the new enumerator
);

Parameter

ppenumAdvise

[out] Points to where the new enumerator should be returned. NULL is a legal return value indicating that there are presently no advisory connections on the object. If an error is returned; this parameter must be set to NULL. Each time an OLE advise holder receives a call to IOleAdviseHolder::EnumAdvise; it must increase the reference count on the pointer it returns. It is the caller's responsibility to call IUnknown::Release when it is done with the pointer.

Return Values

S_OK

Enumerator returned successfully.

E_FAIL

Enumerator could not be returned.

E_NOTIMPL

EnumAdvise is not implemented.

Comments

While an enumeration is in progress; the effect of registering or revoking advisory connections on what is to be enumerated is undefined. The returned enumerator is of type IEnumSTATDATA. It enumerates items of type STATDATA; which are defined as follows:

typedef struct tagSTATDATA {

FORMATETC Formatetc;

DWORD grfAdvf;

IAdviseSink * pAdvise;

DWORD dwConnection;

}STATDATA;

See Also

IOleAdviseHolder::Advise, IOleAdviseHolder::UnAdvise, IOleObject::EnumAdvise

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database