Win32 API 日本語リファレンス
ホームUI.TextServices › IEnumTfInputProcessorProfiles

IEnumTfInputProcessorProfiles

COM
IID71c6e74d-0f28-11d8-a82a-00065b84435c継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

IEnumTfInputProcessorProfiles インターフェイスは TSF マネージャーによって実装され、アプリケーションまたはテキストサービスから使用されます。このインターフェイスは ITfInputProcessorProfileMgr::EnumProfiles によって取得でき、登録済みのプロファイルを列挙します。

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT Clone(IEnumTfInputProcessorProfiles** ppEnum)

IEnumTfInputProcessorProfiles::Clone メソッドは、列挙子オブジェクトのコピーを作成します。

ppEnumIEnumTfInputProcessorProfiles**out[out] IEnumTfInputProcessorProfiles インターフェイスへのポインターです。

戻り値

このメソッドは次の値のいずれかを返します。

説明
S_OK
メソッドは成功しました。
E_FAIL
不特定のエラーが発生しました。
E_INVALIDARG
1 つ以上のパラメーターが無効です。
vtbl 4 HRESULT Next(DWORD ulCount, TF_INPUTPROCESSORPROFILE* pProfile, DWORD* pcFetch)

IEnumTfInputProcessorProfiles::Next メソッドは、現在の位置から、列挙シーケンス内の指定された数の要素を取得します。

ulCountDWORDin[in] 取得する要素の数を指定します。
pProfileTF_INPUTPROCESSORPROFILE*out[out] TF_INPUTPROCESSORPROFILE 構造体の配列へのポインターです。この配列のサイズは少なくとも ulCount 個の要素分が必要です。
pcFetchDWORD*out[out] 実際に取得された要素の数を受け取る ULONG 値へのポインターです。この値は要求した項目数より少ない場合があります。このパラメーターは NULL でもかまいません。

戻り値

このメソッドは次の値のいずれかを返します。

説明
S_OK
メソッドは成功しました。
E_FAIL
不特定のエラーが発生しました。
E_INVALIDARG
1 つ以上のパラメーターが無効です。
vtbl 5 HRESULT Reset()

IEnumTfInputProcessorProfiles::Reset メソッドは、現在の位置を列挙シーケンスの先頭に移動して、列挙子オブジェクトをリセットします。

戻り値

このメソッドは次の値のいずれかを返します。

説明
S_OK
メソッドは成功しました。
vtbl 6 HRESULT Skip(DWORD ulCount)

IEnumTfInputProcessorProfiles::Skip メソッドは、列挙シーケンス内の現在の位置を、指定された数の要素分だけ前方へ移動します。

ulCountDWORDin[in] スキップする要素の数を格納します。

戻り値

このメソッドは次の値のいずれかを返します。

説明
S_OK
メソッドは成功しました。
E_FALSE
指定された数の要素をスキップする前に、列挙の終端に到達しました。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IEnumTfInputProcessorProfiles "{71C6E74D-0F28-11D8-A82A-00065B84435C}"
#usecom global IEnumTfInputProcessorProfiles IID_IEnumTfInputProcessorProfiles "{}"
#comfunc global IEnumTfInputProcessorProfiles_Clone  3 sptr
#comfunc global IEnumTfInputProcessorProfiles_Next   4 int,var,var
#comfunc global IEnumTfInputProcessorProfiles_Reset  5
#comfunc global IEnumTfInputProcessorProfiles_Skip   6 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。