ITextStoreAnchor::QueryInsertEmbedded method (textstor.h)

Article
02/22/2024

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