CreateDataAdviseHolder

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

WINOLEAPI CreateDataAdviseHolder(
  IDataAdviseHolder **ppDAHolder  //Address of output variable that 
                                  // receives the IDataAdviseHolder 
                                  // interface pointer
);
 

Parameter

ppDAHolder
[out] Address of IDataAdviseHolder* pointer variable that receives the interface pointer to the new advise holder object.

Return Values

This function supports the standard return value E_OUTOFMEMORY, as well as the following:

S_OK
The advise holder object has been instantiated and the pointer supplied.

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.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.

See Also

IDataAdviseHolder