Метод ITextStoreACP::GetEmbedded (texttor.h)

Статья
03/02/2024

Возвращает внедренный документ.

Синтаксис

HRESULT GetEmbedded(
  [in]  LONG     acpPos,
  [in]  REFGUID  rguidService,
  [in]  REFIID   riid,
  [out] IUnknown **ppunk
);

Параметры

[in] acpPos

Содержит позицию символа в документе, из которой получается объект .

[in] rguidService

Содержит значение GUID, определяющее запрошенный формат полученного объекта. Это может быть одно из следующих значений.

Значение	Значение
GUID_TS_SERVICE_DATAOBJECT	Объект должен быть получен как объект IDataObject .
GUID_TS_SERVICE_ACCESSIBLE	Объект должен быть получен как доступный объект.
GUID_TS_SERVICE_ACTIVEX	Объект должен быть получен как объект ActiveX.

[in] riid

Указывает запрошенный тип интерфейса.

[out] ppunk

Указатель на указатель IUnknown , который получает запрошенный интерфейс.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров недопустимы.
E_NOTIMPL	Приложение не поддерживает внедренные объекты.
TF_E_INVALIDPOS	acpPos не находится в документе.
TS_E_NOINTERFACE	Запрошенный тип интерфейса не поддерживается.
TS_E_NOLOCK	Вызывающий объект не имеет блокировки только для чтения.
TS_E_NOOBJECT	Внедренный объект в acpPos отсутствует.
TS_E_NOSERVICE	Тип службы, указанный в rguidService , не поддерживается.

Вызывающий объект должен использовать QueryInterface для проверки соответствующих интерфейсов. Потенциальные интерфейсы включают интерфейсы, связанные с внедренными документами или элементами управления, такими как IOleObject , IDataObject , IViewObject , IPersistStorage , IOleCache или IDispatch .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	textstor.h
DLL	Msctf.dll
Распространяемые компоненты	TSF 1.0 в Windows 2000 Professional

См. также раздел

Объекты со специальными возможностями

Idataobject

ITextStoreACP

Поделиться через