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


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

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

Синтаксис

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
Произошла неизвестная ошибка.

Комментарии

Все ссылки на параметр punk освобождаются при уничтожении контекста или при удалении контекста из стека с помощью метода ITfDocumentMgr::P op .

Требования

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

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

ITextStoreACP

ITfContext

ITfContextOwnerCompositionSink

ITfDocumentMgr

ITfDocumentMgr::P op

ITfTextInputProcessor::Activate

ITfThreadMgr::Activate

TfEditCookie