Export (0) Print
Expand All

CreateDataAdviseHolder function

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

Syntax


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 codeDescription
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

See also

IDataAdviseHolder

 

 

Community Additions

ADD
Show:
© 2014 Microsoft