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

The client identifier. (クライアント識別子。) アプリケーションの場合、この値は ITfThreadMgr::Activate の以前の呼び出しによって提供されます。テキストサービスの場合、この値はテキストサービス ITfTextInputProcessor::Activate メソッドで提供されます。

[in] dwFlags

予約済み。0 である必要があります。

[in] punk

ITextStoreACP または ITfContextOwnerCompositionSink インターフェイスをサポートするオブジェクトへのポインター。この値は NULL にすることができます。

[out] ppic

コンテキストを受け取る ITfContext ポインターのアドレス。

[out] pecTextStore

新しいコンテキストの編集 Cookie を受け取る TfEditCookie 値へのポインター。この値は、さまざまなメソッドのコンテキストを識別します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_OUTOFMEMORY	メモリ割り当てエラーが発生しました。
E_FAIL	未指定のエラーが発生しました。

解説

punk パラメーターへのすべての参照は、コンテキストが破棄されたとき、または ITfDocumentMgr::P op メソッドを使用してスタックからコンテキストが削除されるときに解放されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0