ITextStoreACP::InsertEmbedded method (textstor.h)

Inserts an embedded object at the specified character.

Syntax

HRESULT InsertEmbedded(
  [in]  DWORD         dwFlags,
  [in]  LONG          acpStart,
  [in]  LONG          acpEnd,
  [in]  IDataObject   *pDataObject,
  [out] TS_TEXTCHANGE *pChange
);

Parameters

[in] dwFlags

Must be TS_IE_CORRECTION.

[in] acpStart

Contains the starting character position where the object is inserted.

[in] acpEnd

Contains the ending character position where the object is inserted.

[in] pDataObject

Pointer to an IDataObject interface that contains data about the object inserted.

[out] pChange

Pointer to a TS_TEXTCHANGE structure that receives data about the modified text.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
E_INVALIDARG	One or more parameters are invalid.
E_NOTIMPL	The application does not support embedded objects.
TS_E_FORMAT	The application does not support the data type contained in pDataObject.
TS_E_INVALIDPOS	acpStart and/or acpEnd are not within the document.
TS_E_NOLOCK	The caller does not have a read/write lock.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	textstor.h
DLL	Msctf.dll
Redistributable	TSF 1.0 on Windows 2000 Professional

See also

IDataObject

ITextStoreACP

TS_IE_* Constants

TS_TEXTCHANGE