ITextStoreAnchor::InsertEmbedded method (textstor.h)

Inserts an IDataObject data object into a text stream.

Syntax

HRESULT InsertEmbedded(
  [in] DWORD       dwFlags,
  [in] IAnchor     *paStart,
  [in] IAnchor     *paEnd,
  [in] IDataObject *pDataObject
);

Parameters

[in] dwFlags

Must be TS_IE_CORRECTION.

[in] paStart

Pointer to the anchor at the start of the object to be inserted.

[in] paEnd

Pointer to the anchor at the end of the object to be inserted.

[in] pDataObject

Pointer to an IDataObject data object.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_FAIL
The method was unable to obtain a valid interface pointer to the start and/or end anchors.
E_INVALIDARG
One or more input 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
paStart and/or paEnd 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 | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header textstor.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

IDataObject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbedded

ITextStoreAnchor::SetText

TS_CHAR_EMBEDDED

TS_IE_* Constants