IPropertyEnumType
COM公式ドキュメント
列挙情報からデータを抽出するメソッドを公開します。IPropertyEnumType は、プロパティスキーマ内の enum 要素および enumRange 要素へ、実行時にプログラムからアクセスする手段を提供します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
列挙情報構造体から列挙型を取得します。
| penumtype | PROPENUMTYPE* | out | このメソッドが返るとき、列挙型を示す以下のいずれかの値へのポインターが格納されます。 PET_DISCRETEVALUE (0)GetDisplayText と、GetRangeMinValue または GetRangeSetValue のいずれかを使用します。 PET_RANGEDVALUE (1)GetDisplayText と、GetRangeMinValue または GetRangeSetValue のいずれかを使用します。 PET_DEFAULTVALUE (2)GetDisplayText を使用します。 PET_ENDRANGE (3)GetValue または GetRangeMinValue を使用します。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
列挙情報構造体から値を取得します。
| ppropvar | PROPVARIANT* | out | このメソッドが返るとき、プロパティ値へのポインターが格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
列挙情報構造体から最小値を取得します。
| ppropvarMin | PROPVARIANT* | out | このメソッドが返るとき、最小値へのポインターが格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
列挙情報構造体から設定値を取得します。
| ppropvarSet | PROPVARIANT* | out | このメソッドが返るとき、設定値へのポインターが格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
列挙情報構造体から表示テキストを取得します。
| ppszDisplay | LPWSTR* | out | このメソッドが返るとき、表示テキストを格納する null で終わる Unicode 文字列へのポインターのアドレスが格納されます。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
詳細については、enumeratedList を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IPropertyEnumType "{11E1FBF9-2D56-4A6B-8DB3-7CD193A471F2}" #usecom global IPropertyEnumType IID_IPropertyEnumType "{}" #comfunc global IPropertyEnumType_GetEnumType 3 var #comfunc global IPropertyEnumType_GetValue 4 var #comfunc global IPropertyEnumType_GetRangeMinValue 5 var #comfunc global IPropertyEnumType_GetRangeSetValue 6 var #comfunc global IPropertyEnumType_GetDisplayText 7 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IPropertyEnumType "{11E1FBF9-2D56-4A6B-8DB3-7CD193A471F2}" #usecom global IPropertyEnumType IID_IPropertyEnumType "{}" #comfunc global IPropertyEnumType_GetEnumType 3 sptr #comfunc global IPropertyEnumType_GetValue 4 sptr #comfunc global IPropertyEnumType_GetRangeMinValue 5 sptr #comfunc global IPropertyEnumType_GetRangeSetValue 6 sptr #comfunc global IPropertyEnumType_GetDisplayText 7 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。