Share via

CreateOleAdviseHolder

  • Article

This function instantiates an advise holder object for managing compound document notifications. It passes out a pointer to the object's OLE implementation of the IOleAdviseHolder interface.

WINOLEAPI CreateOleAdviseHolder(
  IOleAdviseHolder FAR* FAR* ppOAHolder
);

Parameters

  • ppOAHolder
    [out] Pointer to IOleAdviseHolder* pointer variable that receives the interface pointer to the new advise holder object.

Return Values

This function returns S_OK if it is successful and E_OUTOFMEMORY if it fails.

Remarks

The function CreateOleAdviseHolder creates an instance of an advise holder, which supports the OLE implementation of the IOleAdviseHolder interface. The methods of this interface are intended to be used to implement the advisory methods of IOleObject, and, when advisory connections have been set up with objects supporting an advisory sink, to send notifications of changes in the object to the advisory sink. The advise holder returned by CreateOleAdviseHolder will suffice for the great majority of applications. The OLE-provided implementation does not, however, support IOleAdviseHolder::EnumAdvise, so if you need to use this method, you will need to implement your own advise holder.

Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application.

To determine whether the platform supports this function, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Ole2.h.
Link Library: Ole32.lib.

See Also

IOleAdviseHolder | IOleObject | IOleAdviseHolder::EnumAdvise | Determining Supported COM APIs

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.