IRichEditOle::InsertObject

Inserts an object into a rich edit control.

HRESULT InsertObject(
  REOBJECT FAR *lpreobject  
);
 

Parameters

lpreobject
Pointer to a REOBJECT structure containing the object information and interfaces. The rich edit control automatically increments the reference count for the interfaces if it holds onto them, so the caller can safely release the interfaces if not needed.

Return Values

Returns success status. Use GetScode to retrieve an SCODE. Can be S_OK on success or E_OUTOFMEMORY if memory could not be allocated to insert the object.

If the cp member of the REOBJECT structure is REO_CP_SELECTION, the selection is replaced with the specified object.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in richole.h.

See Also

Rich Edit Controls Overview, Rich Edit OLE Interfaces, IRichEditOle, REOBJECT