Метод ITfDocumentMgr::CreateContext (msctf.h)

Статья
03/05/2024

Создает объект контекста.

Синтаксис

HRESULT CreateContext(
  [in]  TfClientId   tidOwner,
  [in]  DWORD        dwFlags,
  [in]  IUnknown     *punk,
  [out] ITfContext   **ppic,
  [out] TfEditCookie *pecTextStore
);

Параметры

[in] tidOwner

Идентификатор клиента. Для приложения это значение предоставляется при предыдущем вызове метода ITfThreadMgr::Activate. Для службы текста это значение предоставляется в методе службы текста ITfTextInputProcessor::Activate .

[in] dwFlags

Зарезервировано, должно быть равно нулю.

[in] punk

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

[out] ppic

Адрес указателя ITfContext , который получает контекст.

[out] pecTextStore

Указатель на значение TfEditCookie , которое получает файл cookie редактирования для нового контекста. Это значение определяет контекст в различных методах.

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

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

Значение	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.
E_OUTOFMEMORY	Произошла ошибка выделения памяти.
E_FAIL	Произошла неизвестная ошибка.

Требования

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