The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CreateDataAdviseHolder function

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

Syntax

C++


HRESULT CreateDataAdviseHolder(
  _Out_ LPDATAADVISEHOLDER *ppDAHolder
);

Parameters

ppDAHolder [out]: 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.

Return code	Description
E_OUTOFMEMORY	Insufficient memory for the operation.

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

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	ObjBase.h
Library	Ole32.lib
DLL	Ole32.dll