CreateDataAdviseHolder function (ole2.h)

Retrieves a pointer to the OLE implementation of IDataAdviseHolder on the data advise holder object.

Syntax

HRESULT CreateDataAdviseHolder(
  [out] LPDATAADVISEHOLDER *ppDAHolder
);

Parameters

[out] ppDAHolder

Address of an IDataAdviseHolder pointer variable that receives the interface pointer to the new advise holder object.

Return value

This function returns S_OK on success. Other possible values include the following.

Remarks

Call CreateDataAdviseHolder in your implementation of IDataObject::DAdvise to get a pointer to the OLE implementation of IDataAdviseHolder interface. With this pointer, you can then complete the implementation of IDataObject::DAdvise by calling the IDataAdviseHolder::Advise method, which creates an advisory connection between the calling object and the data object.

Requirements

See also

IDataAdviseHolder