使用IMetadataImport

时间:2019-02-17 23:15:06

标签: com windows-runtime midl winmd

简短版

使用 IMetadataImport 时,如何从*.winmd文件中获取与枚举关联的数值?

一个很好的例子是 ApplicationHighContrastAdjustment 枚举:

//Windows.UI.Xaml.ApplicationContrastMode (@020000006)
public enum ApplicationHighContrastAdjustment : uint
{
    None = 0u,
    Auto = 4294967295u
}

大多数枚举为0, 1, 2, ...。但是此枚举成员上还指定了其他值:

  • 0
  • 4294967295

如何阅读以获取那些 UInt32

注意:该问题不必仅适用于WinRT。 C#世界中使用相同的接口来检查.NET托管程序集。 WinRT恰好使用相同的汇编文件格式。

长版

我正在使用IMetadataImport来读取*.winmd(用于WinRT应用程序的TLB的现代版本)的内容。但是这个问题同样适用于读取有关.NET托管程序集的元数据。

如何启动并运行读取winmd元数据文件的abridged version

// Create your metadata dispenser:
IMetadataDispsener dispener;
MetaDataGetDispenser(CLSID_CorMetaDataDispenser, IMetaDataDispenser, out dispenser);

//Open the winmd file we want to dump
String filename = "C:\Windows\System32\WinMetadata\Windows.UI.Xaml.winmd";

IMetaDataImport reader; //IMetadataImport2 supports generics
dispenser.OpenScope(filename, ofRead, IMetaDataImport, out reader); //"Import" is used to read metadata. "Emit" is used to write metadata.

获取有关枚举的信息(自动,无)

我们现在有一个读者。除了可以枚举程序集中的类型之外,我还可以直接跳到该问题的一个有趣的类型:0x02000006

//Get metadata for enum Windows.UI.Xaml.ApplicationHighContrastAdjustment
mdToken tokenID = 0x02000006; //Windows.UI.Xaml.ApplicationHighContrastAdjustment

//btw, this is all hypothetical code that is vaguely C#/Java-like.

Pointer enum = null;
mdToken memberID;
int nCount;
while (reader.EnumMembers(ref enum, tokenID, out memberID, 1, out nCount) == S_OK)
{
   //out MemberID receives the TokenID of each member of the enumeration
}
reader.CloseEnum(enum);

EnumMembers的调用返回了枚举的三个成员:

  • Windows.UI.Xaml.ApplicationContrastMode (@ 02000006)
    • 值__ (@ 04000439,私有)
    • 没有(@ 0400043A,公开)
    • 自动(@ 0400043B,公开)

获取每个枚举值的信息

我们实际上是通过调用 GetMemberProps 来找出他们的名字的(而且这个名字是私人的):

IMetaDataImporter.GetMemberProps(0x0400043A, ...); //"None"
IMetaDataImporter.GetMemberProps(0x0400043B, ...); //"Auto"  

注意:GetMemberProps是一个辅助函数。来自微软:

  

这是一个简单的辅助方法:如果 md 是MethodDef,则我们调用 GetMethodProps ;如果 md 是FieldDef,则我们称为 GetFieldProps 。有关详细信息,请参见这些其他方法。

GetMemberProps 方法返回有关每个枚举值的全部信息-但不返回其实际枚举 value

| Metadata          | @0400043A         | @0400043B       |
|-------------------|-------------------|-----------------|
| Name              | "None"            | "Auto"          |
| Attributes        | 0x00008056        | 0x00008056      |
| Signature         | 06 11 A3 95       | 06 11 A3 95     |
| CodeRVA           | 0x00000000        | 0x00000000      |
| CPlusTypeFlag     | ELEMENT_TYPE_U4   | ELEMENT_TYPE_U4 |
| DefaultValue      | (none)            | (none)          |

我在成员属性中找不到任何指示该枚举分配值的内容。并查看其他 IMetadataImporter 方法:

  • IMetdataImporter
    • GetMemberProps (GetMemberProps是根据类型调用GetMethodProps或GetFieldProps的助手)
      • GetMethodProps
      • GetFieldProps
    • GetPropertyProps
    • GetEventProps
    • GetParamProps
    • GetInterfaceImplProps
    • GetCustomAttributeProps
    • GetTypeDefProps
    • GetTypeRefProps
    • GetScopeProps
    • GetPermissionSetProps
    • GetModuleRefProps
    • GetNestedClassProps
    • GetMemberRefProps

奖金阅读

  • MSDN博客:Metadata Unmanaged API (旧的Word文档的初步PDF版本,据我所知,是Metadata API的唯一Microsoft文档) archive

1 个答案:

答案 0 :(得分:0)

给出我想要的枚举成员的 tokenID

@0400043B = Windows.UI.Xaml.ApplicationHighContrastMode.Auto

您需要遍历 Constant 表(0x0B),并找到 Parent 列(columnIndex = 1)所在的位置。

常量表如下:

Rid  Type (iBYTE)         Parent (iCodedToken)  Value (iBLOB)
===  ===================  ====================  ===============
1    ELEMENT_TYPE_I4 (8)  @04000002             00 00 00 00
2    ELEMENT_TYPE_I4 (8)  @04000003             01 00 00 00
3    ELEMENT_TYPE_I4 (8)  @04000005             00 00 00 00
...
883  ELEMENT_TYPE_I4 (8)  @0400040A             02 00 00 00
884  ELEMENT_TYPE_U4 (9)  @0400043A             00 00 00 00
885  ELEMENT_TYPE_U4 (9)  @0400043B             FF FF FF FF
886  ELEMENT_TYPE_I4 (8)  @0400043D             00 00 00 00
...

IMetadataImporter开始,您需要使用 QueryInterface 作为其IMetadataTables界面:

//Get the tables interface
IMetadataTables tables = reader as IMetadataImporter;

//get the number of rows in the Constant (11) table
UInt32 tabConstant = 11; //the "Constant" table

UInt32 rowSize;
UInt32 rowCount;
UInt32 columnCount;
UInt32 keyColumn;
String tableName;
tables.GetTableInfo(tabConstant,
       out rowSize,
       out rowCount,
       out columnCount,
       out keyColumn,
       out tableName);

现在,在不进行Scunt工作的情况下,您实际上必须手动迭代表:

//Loop over ever row in the Constants table
//and look for Parent (columnIndex=1) is the parent we want
//all code released into the public domain; no attribution required
UInt32 desiredToken = 0x0400043B;

UInt32 colParent = 1; // Parent (iCodedToken)
UInt32 colValue  = 2; // Value  (iBLOB)

for (int i = 0 to rowCount-1)
{
   //Get the Parent codedToken of this row
   UInt32 value;
   tables.GetColumn(tabConstant, colParent, i, outvalue);

   // Is it the parent we're interested in (i.e. @0400043A)
   if (value != desiredToken)
      continue;

   // We found it! Get the value from the "Value" (iBLOB) column 2
   tables.GetColumn(tabConstant, colValue, i, out value);

   //Convert blob UInt32 to a pointer to data
   UInt32 dataLen;
   Pointer data;
   tables.GetBlob(value, out dataLen, out dataLen, out data);

   //Convert the dataLen bytes pointed to by data to a UInt32
   UInt32 enumValue = PUInt32(data)^;

   return enumValue;
}