ホーム › Devices.FunctionDiscovery › IFunctionDiscoveryProvider
IFunctionDiscoveryProvider
COMメソッド 8
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT Initialize(IFunctionDiscoveryProviderFactory* pIFunctionDiscoveryProviderFactory, IFunctionDiscoveryNotification* pIFunctionDiscoveryNotification, DWORD lcidUserDefault, DWORD* pdwStgAccessCapabilities)
| pIFunctionDiscoveryProviderFactory | IFunctionDiscoveryProviderFactory* | in | インスタンス生成等に用いるプロバイダーファクトリインターフェイス。 |
| pIFunctionDiscoveryNotification | IFunctionDiscoveryNotification* | in | 更新通知を送るための通知インターフェイス。 |
| lcidUserDefault | DWORD | in | ユーザー既定のロケールID。 |
| pdwStgAccessCapabilities | DWORD* | out | プロバイダーが対応するストレージアクセス能力を受け取るポインター。 |
vtbl 4 HRESULT Query(IFunctionDiscoveryProviderQuery* pIFunctionDiscoveryProviderQuery, IFunctionInstanceCollection** ppIFunctionInstanceCollection)
| pIFunctionDiscoveryProviderQuery | IFunctionDiscoveryProviderQuery* | in | 実行するクエリ条件を保持するプロバイダークエリインターフェイス。 |
| ppIFunctionInstanceCollection | IFunctionInstanceCollection** | out | クエリ結果のインスタンスコレクションを受け取るポインター。 |
vtbl 5 HRESULT EndQuery()
vtbl 6 HRESULT InstancePropertyStoreValidateAccess(IFunctionInstance* pIFunctionInstance, INT_PTR iProviderInstanceContext, DWORD dwStgAccess)
| pIFunctionInstance | IFunctionInstance* | in | アクセス検証対象の関数インスタンス。 |
| iProviderInstanceContext | INT_PTR | in | プロバイダーがインスタンスに関連付けたコンテキスト値。 |
| dwStgAccess | DWORD | in | 検証するストレージアクセスモードを示す値。 |
vtbl 7 HRESULT InstancePropertyStoreOpen(IFunctionInstance* pIFunctionInstance, INT_PTR iProviderInstanceContext, DWORD dwStgAccess, IPropertyStore** ppIPropertyStore)
| pIFunctionInstance | IFunctionInstance* | in | プロパティストアを開く対象の関数インスタンス。 |
| iProviderInstanceContext | INT_PTR | in | プロバイダーがインスタンスに関連付けたコンテキスト値。 |
| dwStgAccess | DWORD | in | プロパティストアを開くアクセスモードを示す値。 |
| ppIPropertyStore | IPropertyStore** | out | 開いたプロパティストアを受け取るポインター。 |
vtbl 8 HRESULT InstancePropertyStoreFlush(IFunctionInstance* pIFunctionInstance, INT_PTR iProviderInstanceContext)
| pIFunctionInstance | IFunctionInstance* | in | 変更を永続化する対象の関数インスタンス。 |
| iProviderInstanceContext | INT_PTR | in | プロバイダーがインスタンスに関連付けたコンテキスト値。 |
vtbl 9 HRESULT InstanceQueryService(IFunctionInstance* pIFunctionInstance, INT_PTR iProviderInstanceContext, GUID* guidService, GUID* riid, IUnknown** ppIUnknown)
| pIFunctionInstance | IFunctionInstance* | in | サービスを問い合わせる対象の関数インスタンス。 |
| iProviderInstanceContext | INT_PTR | in | プロバイダーがインスタンスに関連付けたコンテキスト値。 |
| guidService | GUID* | in | 要求するサービスを識別するGUID。 |
| riid | GUID* | in | 要求するインターフェイスのIID。 |
| ppIUnknown | IUnknown** | out | 取得したサービスインターフェイスを受け取るポインター。 |
vtbl 10 HRESULT InstanceReleased(IFunctionInstance* pIFunctionInstance, INT_PTR iProviderInstanceContext)
| pIFunctionInstance | IFunctionInstance* | in | 解放された関数インスタンス。 |
| iProviderInstanceContext | INT_PTR | in | 解放されたインスタンスに関連付けられたコンテキスト値。 |
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IFunctionDiscoveryProvider "{DCDE394F-1478-4813-A402-F6FB10657222}" #usecom global IFunctionDiscoveryProvider IID_IFunctionDiscoveryProvider "{}" #comfunc global IFunctionDiscoveryProvider_Initialize 3 sptr,sptr,int,var #comfunc global IFunctionDiscoveryProvider_Query 4 sptr,sptr #comfunc global IFunctionDiscoveryProvider_EndQuery 5 #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreValidateAccess 6 sptr,sptr,int #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreOpen 7 sptr,sptr,int,sptr #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreFlush 8 sptr,sptr #comfunc global IFunctionDiscoveryProvider_InstanceQueryService 9 sptr,sptr,var,var,sptr #comfunc global IFunctionDiscoveryProvider_InstanceReleased 10 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IFunctionDiscoveryProvider "{DCDE394F-1478-4813-A402-F6FB10657222}" #usecom global IFunctionDiscoveryProvider IID_IFunctionDiscoveryProvider "{}" #comfunc global IFunctionDiscoveryProvider_Initialize 3 sptr,sptr,int,sptr #comfunc global IFunctionDiscoveryProvider_Query 4 sptr,sptr #comfunc global IFunctionDiscoveryProvider_EndQuery 5 #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreValidateAccess 6 sptr,sptr,int #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreOpen 7 sptr,sptr,int,sptr #comfunc global IFunctionDiscoveryProvider_InstancePropertyStoreFlush 8 sptr,sptr #comfunc global IFunctionDiscoveryProvider_InstanceQueryService 9 sptr,sptr,sptr,sptr,sptr #comfunc global IFunctionDiscoveryProvider_InstanceReleased 10 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。