如何在使用IMetadataImport时获取枚举值

Question

精简版

在使用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碰巧使用相同的汇编文件格式。

Long version

我正在使用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:WindowsSystem32WinMetadataWindows.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） value__（@ 04000439，私有）无（@ 0400043A，公开）自动（@ 0400043B，公开）

获取每个枚举值的信息

我们通过调用GetMemberProps实际上找到了他们的名字（以及一个是私有的）：

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

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

这是一个简单的辅助方法：如果md是MethodDef，那么我们调用GetMethodProps;如果md是FieldDef，那么我们调用GetFieldProps。有关详细信息，请参阅其他方法

GetMemberProps方法返回有关每个枚举值的全部信息 - 但不是它们的实际枚举值：

| 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

Bonus Reading

MSDN博客：Metadata Unmanaged API（旧的Word文档的初步PDF版本，据我所知，是Metadata API唯一的Microsoft文档）（archive）