Функция CreateTextServices (textserv.h)

Статья
08/26/2023

Функция CreateTextServices создает экземпляр объекта текстовых служб. Объект текстовых служб поддерживает различные интерфейсы, включая ITextServices и текстовую объектную модель (TOM).

Синтаксис

HRESULT CreateTextServices(
  [in]  IUnknown  *punkOuter,
  [in]  ITextHost *pITextHost,
  [out] IUnknown  **ppUnk
);

Параметры

[in] punkOuter

Тип: IUnknown*

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

[in] pITextHost

Тип: ITextHost*

Указатель на реализацию интерфейса ITextHost . Этот указатель не должен иметь значение NULL.

[out] ppUnk

Тип: IUnknown**

Указатель на переменную, которая получает указатель на частный IUnknown объекта текстовых служб. Вы можете вызвать QueryInterface для этого указателя, чтобы получить указатели интерфейса ITextServices или ITextDocument .

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

Тип: HRESULT

Если объект текстовых служб был успешно создан, возвращаемое значение будет S_OK.

Если функция завершается сбоем, возвращается один из следующих кодов com-ошибок. Дополнительные сведения о кодах ошибок COM см. в разделе Обработка ошибок в COM.

Код возврата	Описание
E_INVALIDARG	Передан недопустимый аргумент.
E_OUTOFMEMORY	Не удалось выделить память для объекта текстовых служб.
E_FAIL	Не удалось инициализировать объект службы текста.

Объект текстовых служб можно создать как часть стандартного объекта com-агрегирования. Если это так, то вызывающие объекты должны следовать стандартным правилам OLE32 для работы с агрегированными объектами и указателями интерфейса кэширования, полученными с помощью QueryInterface из частного IUnknown.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	textserv.h
Библиотека	Riched20.lib
DLL	Msftedit.dll