ITfQueryEmbedded::QueryInsertEmbedded method (msctf.h)

Determines if the active context can accept an embedded object.

Syntax

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

Parameters

[in] pguidService

A GUID that identifies the service associated with the object. This value can be NULL if pFormatEtc is valid.

[in] pFormatEtc

Pointer to a FORMATETC structure that contains data about the object to be embedded. This value can be NULL if pguidService is valid.

[out] pfInsertable

Pointer to a Boolean value that receives the query result. This value receives a nonzero value if the object can be embedded, or zero otherwise.

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.
TF_E_DISCONNECTED	There is no active context.

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	msctf.h
DLL	Msctf.dll
Redistributable	TSF 1.0 on Windows 2000 Professional

See also

ITfQueryEmbedded

The FORMATETC Structure