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

ICatalogCollection

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

メソッド 16

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

vtbl 7 HRESULT get__NewEnum(IUnknown** ppEnumVariant)
ppEnumVariantIUnknown**outコレクションを列挙する IEnumVARIANT 列挙子の IUnknown インターフェイスを受け取るポインタである。
vtbl 8 HRESULT get_Item(INT lIndex, IDispatch** ppCatalogObject)
lIndexINTin取得する項目の 0 始まりのインデックスを指定する。
ppCatalogObjectIDispatch**out指定インデックスのカタログオブジェクトを表す IDispatch インターフェイスを受け取るポインタである。
vtbl 9 HRESULT get_Count(INT* plObjectCount)
plObjectCountINT*outコレクション内のオブジェクト数を受け取るポインタである。
vtbl 10 HRESULT Remove(INT lIndex)
lIndexINTinコレクションから削除する項目の 0 始まりのインデックスを指定する。
vtbl 11 HRESULT Add(IDispatch** ppCatalogObject)
ppCatalogObjectIDispatch**outコレクションに追加された新規カタログオブジェクトを表す IDispatch インターフェイスを受け取るポインタである。
vtbl 12 HRESULT Populate()
vtbl 13 HRESULT SaveChanges(INT* pcChanges)
pcChangesINT*out保存処理によって変更されたオブジェクトの数を受け取るポインタである。
vtbl 14 HRESULT GetCollection(LPWSTR bstrCollName, VARIANT varObjectKey, IDispatch** ppCatalogCollection)
bstrCollNameLPWSTRin取得する下位コレクションの名前を指定する。
varObjectKeyVARIANTin親オブジェクトを特定するキー値を格納した VARIANT を渡す。
ppCatalogCollectionIDispatch**out取得した下位カタログコレクションを表す IDispatch インターフェイスを受け取るポインタである。
vtbl 15 HRESULT get_Name(VARIANT* pVarNamel)
pVarNamelVARIANT*outコレクションの名前を受け取る VARIANT へのポインタである。
vtbl 16 HRESULT get_AddEnabled(VARIANT_BOOL* pVarBool)
pVarBoolVARIANT_BOOL*outこのコレクションへの項目追加が許可されているかどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 17 HRESULT get_RemoveEnabled(VARIANT_BOOL* pVarBool)
pVarBoolVARIANT_BOOL*outこのコレクションからの項目削除が許可されているかどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 18 HRESULT GetUtilInterface(IDispatch** ppIDispatch)
ppIDispatchIDispatch**outコレクション固有のユーティリティインターフェイスを表す IDispatch を受け取るポインタである。
vtbl 19 HRESULT get_DataStoreMajorVersion(INT* plMajorVersion)
plMajorVersionINT*outデータストアのメジャーバージョン番号を受け取るポインタである。
vtbl 20 HRESULT get_DataStoreMinorVersion(INT* plMinorVersionl)
plMinorVersionlINT*outデータストアのマイナーバージョン番号を受け取るポインタである。
vtbl 21 HRESULT PopulateByKey(SAFEARRAY* psaKeys)
psaKeysSAFEARRAY*in読み込む対象を特定するキーの配列を格納した SAFEARRAY へのポインタである。
vtbl 22 HRESULT PopulateByQuery(LPWSTR bstrQueryString, INT lQueryType)
bstrQueryStringLPWSTRinコレクションを読み込むためのクエリ文字列を指定する。
lQueryTypeINTinクエリの種類を示す値を指定する。

HSP用 COM定義

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

出力引数: 
#define global IID_ICatalogCollection "{6EB22872-8A19-11D0-81B6-00A0C9231C29}"
#usecom global ICatalogCollection IID_ICatalogCollection "{6EB22883-8A19-11D0-81B6-00A0C9231C29}"
#comfunc global ICatalogCollection_get__NewEnum               7 sptr
#comfunc global ICatalogCollection_get_Item                   8 int,sptr
#comfunc global ICatalogCollection_get_Count                  9 var
#comfunc global ICatalogCollection_Remove                     10 int
#comfunc global ICatalogCollection_Add                        11 sptr
#comfunc global ICatalogCollection_Populate                   12
#comfunc global ICatalogCollection_SaveChanges                13 var
#comfunc global ICatalogCollection_GetCollection              14 wstr,int,sptr
#comfunc global ICatalogCollection_get_Name                   15 var
#comfunc global ICatalogCollection_get_AddEnabled             16 var
#comfunc global ICatalogCollection_get_RemoveEnabled          17 var
#comfunc global ICatalogCollection_GetUtilInterface           18 sptr
#comfunc global ICatalogCollection_get_DataStoreMajorVersion  19 var
#comfunc global ICatalogCollection_get_DataStoreMinorVersion  20 var
#comfunc global ICatalogCollection_PopulateByKey              21 var
#comfunc global ICatalogCollection_PopulateByQuery            22 wstr,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。