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