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

支援 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