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

ISettingsContext

COM
IID9f7d7bbd-20b3-11da-81a5-0030f1642e3c継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT Serialize(IStream* pStream, ITargetInfo* pTarget)
pStreamIStream*inコンテキストの内容を書き込む先のストリームへのポインタである。
pTargetITargetInfo*inシリアル化の対象となるターゲット情報を表す ITargetInfo へのポインタである。
vtbl 4 HRESULT Deserialize(IStream* pStream, ITargetInfo* pTarget, ISettingsResult*** pppResults, UINT_PTR* pcResultCount)
pStreamIStream*inコンテキストの内容を読み込むストリームへのポインタである。
pTargetITargetInfo*in逆シリアル化の対象となるターゲット情報を表す ITargetInfo へのポインタである。
pppResultsISettingsResult***out逆シリアル化の結果を表す ISettingsResult インターフェイスの配列を受け取るポインタである。
pcResultCountUINT_PTR*out返された結果の個数を受け取るポインタである。
vtbl 5 HRESULT SetUserData(void* pUserData)
pUserDatavoid*inコンテキストに関連付けるユーザーデータへのポインタである。
vtbl 6 HRESULT GetUserData(void** pUserData)
pUserDatavoid**outコンテキストに関連付けられたユーザーデータを受け取るポインタである。
vtbl 7 HRESULT GetNamespaces(IItemEnumerator** ppNamespaceIds)
ppNamespaceIdsIItemEnumerator**outコンテキストに含まれる名前空間の識別子を列挙する IItemEnumerator を受け取るポインタである。
vtbl 8 HRESULT GetStoredSettings(ISettingsIdentity* pIdentity, IItemEnumerator** ppAddedSettings, IItemEnumerator** ppModifiedSettings, IItemEnumerator** ppDeletedSettings)
pIdentityISettingsIdentity*in対象とする名前空間を識別する設定アイデンティティへのポインタである。
ppAddedSettingsIItemEnumerator**out追加された設定を列挙する IItemEnumerator を受け取るポインタである。
ppModifiedSettingsIItemEnumerator**out変更された設定を列挙する IItemEnumerator を受け取るポインタである。
ppDeletedSettingsIItemEnumerator**out削除された設定を列挙する IItemEnumerator を受け取るポインタである。
vtbl 9 HRESULT RevertSetting(ISettingsIdentity* pIdentity, LPWSTR pwzSetting)
pIdentityISettingsIdentity*in対象とする名前空間を識別する設定アイデンティティへのポインタである。
pwzSettingLPWSTRin元に戻す設定項目へのパスを指定する。

HSP用 COM定義

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

出力引数:
#define global IID_ISettingsContext "{9F7D7BBD-20B3-11DA-81A5-0030F1642E3C}"
#usecom global ISettingsContext IID_ISettingsContext "{}"
#comfunc global ISettingsContext_Serialize          3 sptr,sptr
#comfunc global ISettingsContext_Deserialize        4 sptr,sptr,sptr,var
#comfunc global ISettingsContext_SetUserData        5 sptr
#comfunc global ISettingsContext_GetUserData        6 sptr
#comfunc global ISettingsContext_GetNamespaces      7 sptr
#comfunc global ISettingsContext_GetStoredSettings  8 sptr,sptr,sptr,sptr
#comfunc global ISettingsContext_RevertSetting      9 sptr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。