Win32 API 日本語リファレンス
ホーム › UI.Controls.RichEdit › PCreateTextServices

PCreateTextServices

コールバック

シグネチャ

HRESULT PCreateTextServices(
    IUnknown* punkOuter,
    ITextHost* pITextHost,
    IUnknown** ppUnk
);

パラメーター

フィールド型説明
punkOuterIUnknown*テキストサービスオブジェクトが集約オブジェクトの一部として作成される場合に、外側のオブジェクトの制御 IUnknown インターフェイスへのポインターを指定します。オブジェクトが集約の一部でない場合、このパラメーターは NULL でもかまいません。
pITextHostITextHost*ITextHost インターフェイスの実装へのポインターを指定します。このポインターを NULL にすることはできません。
ppUnkIUnknown**テキストサービスオブジェクトのプライベート IUnknown へのポインターを受け取る変数へのポインターです。このポインターに対して QueryInterface を呼び出すことで、ITextServices または ITextDocument のインターフェイスポインターを取得できます。

公式ドキュメント

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

戻り値

Type: HRESULT

テキストサービスオブジェクトの作成に成功した場合、戻り値は S_OK です。

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

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

解説(Remarks)

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

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)