ITextStoreAnchor::QueryInsertEmbedded method (textstor.h)

Determines whether the document can accept an embedded object through the InsertEmbedded or InsertEmbeddedAtSelection methods.

Syntax

HRESULT QueryInsertEmbedded(
  [in]  const GUID      *pguidService,
  [in]  const FORMATETC *pFormatEtc,
  [out] BOOL            *pfInsertable
);

Parameters

[in] pguidService

Pointer to the object type. If NULL, pFormatEtc should be used.

[in] pFormatEtc

Pointer to the FORMATETC structure that contains format data of the object. This parameter cannot be NULL if the pguidService parameter is NULL.

[out] pfInsertable

Receives TRUE if the object type can be inserted into the document or FALSE if the object type cannot be inserted into the document.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_INVALIDARG
The pFormatEtc parameter is NULL.

Remarks

The clipboard formats supported by the document are dependent on the application.

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

FORMATETC

ITextStoreAnchor

ITextStoreAnchor::InsertEmbedded

ITextStoreAnchor::InsertEmbeddedAtSelection