CreateTextServices 関数 (textserv.h)

  • [アーティクル]

CreateTextServices 関数は、テキスト サービス オブジェクトのインスタンスを作成します。 テキスト サービス オブジェクトは、 ITextServices や Text Object Model (TOM) など、さまざまなインターフェイスをサポートしています。

構文

HRESULT CreateTextServices(
  [in]  IUnknown  *punkOuter,
  [in]  ITextHost *pITextHost,
  [out] IUnknown  **ppUnk
);

パラメーター

[in] punkOuter

種類: IUnknown*

テキスト サービス オブジェクトが集計オブジェクトの一部として作成されている場合は、外部オブジェクトの制御する IUnknown インターフェイスへのポインター。 オブジェクトが集計の一部でない場合、このパラメーターは NULL にすることができます。

[in] pITextHost

種類: ITextHost*

ITextHost インターフェイスの実装へのポインター。 このポインターは NULL にすることはできません。

[out] ppUnk

種類: IUnknown**

テキスト サービス オブジェクトのプライベート IUnknown へのポインターを受け取る変数へのポインター。 このポインターで QueryInterface を 呼び出して 、ITextServices または ITextDocument インターフェイス ポインターを取得できます。

戻り値

種類: HRESULT

テキスト サービス オブジェクトが正常に作成された場合、戻り値はS_OK。

関数が失敗した場合は、次のいずれかの COM エラー コードが返されます。 COM エラー コードの詳細については、「COM でのエラー処理」を参照してください。

リターン コード 説明
E_INVALIDARG
 無効な引数が渡されました。
E_OUTOFMEMORY
 テキスト サービス オブジェクトのメモリを割り当てませんでした。
E_FAIL
 テキスト サービス オブジェクトを初期化できませんでした。

注釈

テキスト サービス オブジェクトは、標準の COM 集計オブジェクトの一部として作成できます。 その場合、呼び出し元は、集約されたオブジェクトを処理し、プライベート IUnknown から QueryInterface を介して取得されたインターフェイス ポインターをキャッシュするための標準の OLE32 規則に従う必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー textserv.h
Library Riched20.lib
[DLL] Msftedit.dll

関連項目

概念

ITextDocument

ITextHost

ITextServices

リファレンス

ウィンドウレスリッチエディットコントロール