Win32 API 日本語リファレンス
ホーム › System.Performance › IValueMap

IValueMap

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID03837534-098b-11d8-9414-505054503030継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 14

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Count(INT* retVal)
retValINT*out現在の要素数を受け取るポインタである。
vtbl 8 HRESULT get_Item(VARIANT index, IValueMapItem** value)
indexVARIANTin取得する要素のインデックスまたはキーを表す VARIANT を指定する。
valueIValueMapItem**out指定した値マップ項目を表す IValueMapItem を受け取るポインタである。
vtbl 9 HRESULT get__NewEnum(IUnknown** retVal)
retValIUnknown**outコレクションを反復処理する列挙子(IEnumVARIANT)を受け取るポインタである。
vtbl 10 HRESULT get_Description(LPWSTR* description)
descriptionLPWSTR*out現在の説明文を受け取るポインタである。
vtbl 11 HRESULT put_Description(LPWSTR description)
descriptionLPWSTRin説明文を設定する。
vtbl 12 HRESULT get_Value(VARIANT* Value)
ValueVARIANT*out値マップ全体の値を表す VARIANT を受け取るポインタである。
vtbl 13 HRESULT put_Value(VARIANT Value)
ValueVARIANTin値マップ全体に設定する値を表す VARIANT を指定する。
vtbl 14 HRESULT get_ValueMapType(ValueMapType* type)
typeValueMapType*out値マップの種類を受け取るポインタである。
vtbl 15 HRESULT put_ValueMapType(ValueMapType type)
typeValueMapTypein値マップの種類を指定する。
vtbl 16 HRESULT Add(VARIANT value)
valueVARIANTin追加する値を表す VARIANT を指定する。
vtbl 17 HRESULT Remove(VARIANT value)
valueVARIANTin削除する値を表す VARIANT を指定する。
vtbl 18 HRESULT Clear()
vtbl 19 HRESULT AddRange(IValueMap* map)
mapIValueMap*inoptional追加する値マップを指定する。
vtbl 20 HRESULT CreateValueMapItem(IValueMapItem** Item)
ItemIValueMapItem**out新しく作成した値マップ項目を表す IValueMapItem を受け取るポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IValueMap "{03837534-098B-11D8-9414-505054503030}"
#usecom global IValueMap IID_IValueMap "{}"
#comfunc global IValueMap_get_Count           7 var
#comfunc global IValueMap_get_Item            8 int,sptr
#comfunc global IValueMap_get__NewEnum        9 sptr
#comfunc global IValueMap_get_Description     10 var
#comfunc global IValueMap_put_Description     11 wstr
#comfunc global IValueMap_get_Value           12 var
#comfunc global IValueMap_put_Value           13 int
#comfunc global IValueMap_get_ValueMapType    14 var
#comfunc global IValueMap_put_ValueMapType    15 int
#comfunc global IValueMap_Add                 16 int
#comfunc global IValueMap_Remove              17 int
#comfunc global IValueMap_Clear               18
#comfunc global IValueMap_AddRange            19 sptr
#comfunc global IValueMap_CreateValueMapItem  20 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。