Win32 API 日本語リファレンス
ホームSystem.Diagnostics.Debug.Extensions › IDynamicKeyProviderConcept

IDynamicKeyProviderConcept

COM
IIDe7983fa1-80a7-498c-988f-518ddc5d4025継承元IUnknown自前メソッド開始 vtbl3

メソッド 3

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

vtbl 3 HRESULT GetKey(IModelObject* contextObject, LPWSTR key, IModelObject** keyValue, IKeyStore** metadata, BOOLEAN* hasKey)
contextObjectIModelObject*inキーを取得する対象のモデルオブジェクトへのポインタである。
keyLPWSTRin取得するキーの名前を指定する。
keyValueIModelObject**outoptional指定したキーの値を表すモデルオブジェクトを受け取る出力ポインタである。
metadataIKeyStore**outoptionalキー値に付随するメタデータを格納したキーストアを受け取る出力ポインタである。不要なら NULL を指定できる。
hasKeyBOOLEAN*outoptional指定したキーが存在したか否かを受け取る出力ブール値ポインタである。
vtbl 4 HRESULT SetKey(IModelObject* contextObject, LPWSTR key, IModelObject* keyValue, IKeyStore* metadata)
contextObjectIModelObject*inキーを設定する対象のモデルオブジェクトへのポインタである。
keyLPWSTRin設定するキーの名前を指定する。
keyValueIModelObject*inキーに設定する値を表すモデルオブジェクトへのポインタである。
metadataIKeyStore*inキーに関連付けるメタデータを格納したキーストアへのポインタである。NULL も指定できる。
vtbl 5 HRESULT EnumerateKeys(IModelObject* contextObject, IKeyEnumerator** ppEnumerator)
contextObjectIModelObject*inキーを列挙する対象のモデルオブジェクトへのポインタである。
ppEnumeratorIKeyEnumerator**out対象オブジェクトのキー群を列挙する IKeyEnumerator を受け取る出力ポインタである。

HSP用 COM定義

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

出力引数:
#define global IID_IDynamicKeyProviderConcept "{E7983FA1-80A7-498C-988F-518DDC5D4025}"
#usecom global IDynamicKeyProviderConcept IID_IDynamicKeyProviderConcept "{}"
#comfunc global IDynamicKeyProviderConcept_GetKey         3 sptr,wstr,sptr,sptr,var
#comfunc global IDynamicKeyProviderConcept_SetKey         4 sptr,wstr,sptr,sptr
#comfunc global IDynamicKeyProviderConcept_EnumerateKeys  5 sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。