IMetaDataImport2
COM公式ドキュメント
IMetaDataImport インターフェースを拡張し、ジェネリック型を扱う機能を提供します。
メソッド 8
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
指定した TypeDef または MethodDef トークンに関連付けられたジェネリックパラメーターのトークン配列に対する列挙子を取得します。
| phEnum | void** | inout | 列挙子へのポインター。 |
| tk | DWORD | in | ジェネリックパラメーターを列挙する対象の TypeDef または MethodDef トークン。 |
| rGenericParams | DWORD* | inout | 列挙するジェネリックパラメーターの配列。 |
| cMax | DWORD | in | rGenericParams に格納するトークンの要求される最大数。 |
| pcGenericParams | DWORD* | inout | rGenericParams に格納されたトークンの返却数。 |
戻り値
| HRESULT | 説明 |
|---|---|
| S_OK | EnumGenericParams が正常に返りました。 |
| S_FALSE | phEnum にメンバー要素がありません。この場合、pcGenericParams は 0(ゼロ)に設定されます。 |
指定したトークンで表されるジェネリックパラメーターに関連付けられたメタデータを取得します。
| gp | DWORD | in | メタデータを返す対象のジェネリックパラメーターを表すトークン。 |
| pulParamSeq | DWORD* | inout | 親のコンストラクターまたはメソッド内における Type パラメーターの序数位置。 |
| pdwParamFlags | DWORD* | inout | ジェネリックパラメーターの Type を記述する CorGenericParamAttr 列挙体の値。 |
| ptOwner | DWORD* | inout | パラメーターの所有者を表す TypeDef または MethodDef トークン。 |
| reserved | DWORD* | inout | 将来の拡張のために予約されています。 |
| wzname | LPWSTR | outoptional | ジェネリックパラメーターの名前。 |
| cchName | DWORD | in | wzName バッファーのサイズ。 |
| pchName | DWORD* | inout | 返される名前のサイズ(ワイド文字単位)。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
指定した MethodSpec トークンで参照されるメソッドのメタデータシグネチャを取得します。
| mi | DWORD | in | メソッドのインスタンス化を表す MethodSpec トークン。 |
| tkParent | DWORD* | inout | メソッド定義を表す MethodDef または MethodRef トークンへのポインター。 |
| ppvSigBlob | BYTE** | inout | メソッドのバイナリメタデータシグネチャへのポインター。 |
| pcbSigBlob | DWORD* | inout | ppvSigBlob のサイズ(バイト単位)。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
指定したトークンで表されるジェネリックパラメーターに関連付けられたジェネリックパラメーター制約のトークン配列に対する列挙子を取得します。
| phEnum | void** | inout | 列挙子へのポインター。 |
| tk | DWORD | in | 制約を列挙する対象のジェネリックパラメーターを表すトークン。 |
| rGenericParamConstraints | DWORD* | inout | 列挙するジェネリックパラメーター制約の配列。 |
| cMax | DWORD | in | rGenericParamConstraints に格納するトークンの要求される最大数。 |
| pcGenericParamConstraints | DWORD* | inout | rGenericParamConstraints に格納されたトークン数へのポインター。 |
戻り値
| HRESULT | 説明 |
|---|---|
| S_OK | EnumGenericParamConstraints が正常に返りました。 |
| S_FALSE | phEnum にメンバー要素がありません。この場合、pcGenericParameterConstraints は 0(ゼロ)に設定されます。 |
指定した制約トークンで表されるジェネリックパラメーター制約に関連付けられたメタデータを取得します。
| gpc | DWORD | in | メタデータを返す対象のジェネリックパラメーター制約へのトークン。 |
| ptGenericParam | DWORD* | inout | 制約されるジェネリックパラメーターを表すトークンへのポインター。 |
| ptkConstraintType | DWORD* | inout | ptGenericParam に対する制約を表す TypeDef、TypeRef、または TypeSpec トークンへのポインター。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
現在のメタデータスコープで定義されている、ポータブル実行可能(PE)ファイル(通常は DLL または EXE ファイル)内のコードの性質を識別する値を取得します。
| pdwPEKind | DWORD* | inout | PE ファイルを記述する CorPEKind 列挙体の値へのポインター。 |
| pdwMAchine | DWORD* | inout | マシンのアーキテクチャを識別する値へのポインター。取り得る値については次のセクションを参照してください。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
pdwMachine パラメーターが参照する値は、次のいずれかになります。
| 値 | マシンアーキテクチャ |
|---|---|
|
IMAGE_FILE_MACHINE_I386
0x014C |
x86 |
|
IMAGE_FILE_MACHINE_IA64
0x0200 |
Intel IPF |
|
IMAGE_FILE_MACHINE_AMD64
0x8664 |
x64 |
アセンブリのビルドに使用されたランタイムのバージョン番号を取得します。
| pwzBuf | LPWSTR | outoptional | バージョンを指定する文字列を格納する配列。 |
| ccBufSize | DWORD | in | pwzBuf 配列のサイズ(ワイド文字単位)。 |
| pccBufSize | DWORD* | inout | pwzBuf 配列に返される、null 終端文字を含むワイド文字数。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
GetVersionString メソッドは、現在のメタデータスコープのビルド対象バージョンを取得します。スコープが一度も保存されていない場合、ビルド対象バージョンは存在せず、空の文字列が返されます。
指定した MethodDef または MemberRef トークンに関連付けられた MethodSpec トークンの配列に対する列挙子を取得します。
| phEnum | void** | inout | rMethodSpecs に対する列挙子へのポインター。 |
| tk | DWORD | in | MethodSpec トークンを列挙する対象のメソッドを表す MemberRef または MethodDef トークン。tk の値が 0(ゼロ)の場合、スコープ内のすべての MethodSpec トークンが列挙されます。 |
| rMethodSpecs | DWORD* | inout | 列挙する MethodSpec トークンの配列。 |
| cMax | DWORD | in | rMethodSpecs に格納するトークンの要求される最大数。 |
| pcMethodSpecs | DWORD* | inout | rMethodSpecs に格納されたトークンの返却数。 |
戻り値
| HRESULT | 説明 |
|---|---|
| S_OK | EnumMethodSpecs が正常に返りました。 |
| S_FALSE | phEnum にメンバー要素がありません。この場合、pcMethodSpecs は 0(ゼロ)に設定されます。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IMetaDataImport2 "{FCE5EFA0-8BBA-4F8E-A036-8F2022B08466}" #usecom global IMetaDataImport2 IID_IMetaDataImport2 "{}" #comfunc global IMetaDataImport2_EnumGenericParams 65 sptr,int,var,int,var #comfunc global IMetaDataImport2_GetGenericParamProps 66 int,var,var,var,var,var,int,var #comfunc global IMetaDataImport2_GetMethodSpecProps 67 int,var,var,var #comfunc global IMetaDataImport2_EnumGenericParamConstraints 68 sptr,int,var,int,var #comfunc global IMetaDataImport2_GetGenericParamConstraintProps 69 int,var,var #comfunc global IMetaDataImport2_GetPEKind 70 var,var #comfunc global IMetaDataImport2_GetVersionString 71 var,int,var #comfunc global IMetaDataImport2_EnumMethodSpecs 72 sptr,int,var,int,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IMetaDataImport2 "{FCE5EFA0-8BBA-4F8E-A036-8F2022B08466}" #usecom global IMetaDataImport2 IID_IMetaDataImport2 "{}" #comfunc global IMetaDataImport2_EnumGenericParams 65 sptr,int,sptr,int,sptr #comfunc global IMetaDataImport2_GetGenericParamProps 66 int,sptr,sptr,sptr,sptr,sptr,int,sptr #comfunc global IMetaDataImport2_GetMethodSpecProps 67 int,sptr,sptr,sptr #comfunc global IMetaDataImport2_EnumGenericParamConstraints 68 sptr,int,sptr,int,sptr #comfunc global IMetaDataImport2_GetGenericParamConstraintProps 69 int,sptr,sptr #comfunc global IMetaDataImport2_GetPEKind 70 sptr,sptr #comfunc global IMetaDataImport2_GetVersionString 71 sptr,int,sptr #comfunc global IMetaDataImport2_EnumMethodSpecs 72 sptr,int,sptr,int,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。