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

ISettingsNamespace

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

メソッド 7

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

vtbl 3 HRESULT GetIdentity(ISettingsIdentity** SettingsID)
SettingsIDISettingsIdentity**outこの名前空間を識別する設定アイデンティティを受け取るポインタである。
vtbl 4 HRESULT Settings(IItemEnumerator** Settings)
SettingsIItemEnumerator**out名前空間内の設定項目を列挙する IItemEnumerator インターフェイスを受け取るポインタである。
vtbl 5 HRESULT Save(BOOL PushSettings, ISettingsResult** Result)
PushSettingsBOOLin保存時に設定を適用(プッシュ)する場合は TRUE を指定する。
ResultISettingsResult**out保存処理の結果を表す ISettingsResult インターフェイスを受け取るポインタである。
vtbl 6 HRESULT GetSettingByPath(LPWSTR Path, ISettingsItem** Setting)
PathLPWSTRin取得する設定項目へのパスを指定する。
SettingISettingsItem**out指定したパスの設定項目を表す ISettingsItem インターフェイスを受け取るポインタである。
vtbl 7 HRESULT CreateSettingByPath(LPWSTR Path, ISettingsItem** Setting)
PathLPWSTRin作成する設定項目へのパスを指定する。
SettingISettingsItem**out作成された設定項目を表す ISettingsItem インターフェイスを受け取るポインタである。
vtbl 8 HRESULT RemoveSettingByPath(LPWSTR Path)
PathLPWSTRin削除する設定項目へのパスを指定する。
vtbl 9 HRESULT GetAttribute(LPWSTR Name, VARIANT* Value)
NameLPWSTRin取得する属性の名前を指定する。
ValueVARIANT*out指定した属性の値を受け取る VARIANT へのポインタである。

HSP用 COM定義

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

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