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

保留,必须为 0。

[in] punk

指向支持 ITextStoreACPITfContextOwnerCompositionSink 接口的 对象的指针。 此值可以为 NULL

[out] ppic

接收上下文的 ITfContext 指针的地址。

[out] pecTextStore

指向接收新上下文的编辑 Cookie 的 TfEditCookie 值的指针。 此值标识各种方法中的上下文。

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
E_OUTOFMEMORY
发生内存分配错误。
E_FAIL
发生了未指定的错误。

注解

销毁上下文或使用 ITfDocumentMgr::P op 方法从堆栈中删除上下文时,将释放对 punk 参数的所有引用。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITextStoreACP

ITfContext

ITfContextOwnerCompositionSink

ITfDocumentMgr

ITfDocumentMgr::P op

ITfTextInputProcessor::Activate

ITfThreadMgr::Activate

TfEditCookie