3

精简版

*.winmd使用IMetadataImport时如何从文件中获取接口的接口标识符 (IID) ？

例如Windows.Globalization.ICalendar：{CA30221D-86D9-40FB-A26B-D44EB7CF08EA}

更长的版本

一个很好的例子是Windows.Globalization.ICalendar接口。它的 IID 是CA30221D-86D9-40FB-A26B-D44EB7CF08EA.

它在 IDL 中

您可以在源Windows.Globalization.idl文件中找到它：

[exclusiveto(Windows.Globalization.Calendar)]
[uuid(CA30221D-86D9-40FB-A26B-D44EB7CF08EA)]
[version(0x06020000)]
interface ICalendar : IInspectable
{
   //...snip...
}

提醒：您不应该解析这些文件。它被编译成一个*.winmd程序集，而那个数据库就是事实。

它在标题中

您可以在使用导入工具windows.globalization.h生成的文件中找到它：*.winmd

namespace ABI {
    namespace Windows {
        namespace Globalization {
            
            MIDL_INTERFACE("CA30221D-86D9-40FB-A26B-D44EB7CF08EA")
            ICalendar : public IInspectable
            {
               //...snip...
            }

它甚至在winmd中

您甚至可以在生成的已编译*.winmd程序集数据库中找到 InterfaceID：

在此处输入图像描述

但是在使用文档化API时如何获取它？IMetadataImporter

代码

如何启动和运行读取元数据文件的精简版：winmd

// 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.Globalization.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.

奖金阅读

  • MSDN 博客：元数据非托管 API （一个旧 Word 文档的初步 PDF 版本，据我所知，它是元数据 API 的唯一 Microsoft 文档） （存档）
4

1 回答 1

0

精简版

自定义属性blob是Guid类的 C# 序列化格式：

3.2.2 定义自定义属性

用于定义自定义属性的pBlob格式在本规范后面定义。（广义上讲，blob 记录类构造函数的参数值，以及命名字段/属性的零个或多个值 - 换句话说，在发出元数据时实例化指定的对象所需的信息）。如果构造函数不需要参数，则不需要提供 blob 参数。

4.3.6 获取自定义属性属性

自定义属性存储为 blob，其格式可由元数据引擎和反射理解；本质上是构造函数方法的参数值列表，它将创建自定义属性的实例。

为了获得GuidAttriute guid 值，您必须模拟 C# 从流中反序列化Guid对象。

长版

从您的IMetadataImport开始，您调用IMetaDataImport.GetCustomAttributeByName。

第一个棘手的部分是弄清楚我所追求的属性的名称。我知道Guid在 IDL 或 C# 中查看时：

[Guid("CA30221D-86D9-40FB-A26B-D44EB7CF08EA")]
interface ICalendar
{
    //...
}

而在它下面实际上会被称为"GuidAttribute". 但这些都没有真正起作用：

  • "Guid": 失败S_FALSE
  • "GuidAttribute": 失败S_FALSE

你可以试试属性类的全名：

  • "System.Runtime.InteropServices.GuidAttribute"

但这也失败了，因为这是 .NET 框架中GuidAttribute类的名称。在 WinRT 库中，您必须使用"Windows.Foundation.Metadata.GuidAttribute"：

  • "Guid": 失败S_FALSE
  • "GuidAttribute": 失败S_FALSE
  • "System.Runtime.InteropServices.GuidAttribute": 失败S_FALSE（仅限 CLR）
  • "Windows.Foundation.Metadata.GuidAttribute": 工作

现在我们确定了要查找的属性的名称，我们可以查询它：

mdToken calendarTokenID = 0x02000022; //Windows.Globalization.ICalendar
String  attributeName   = "Windows.Foundation.Metadata.GuidAttribute";

Pointer blob;
UInt32 blobLen;
reader.GetCustomAttributeByName(calendarTokenID, attributeName, out blob, out blobLen);

下一个棘手的部分是解码 blob。

解码 blob

每个自定义属性都有不同的序列化格式。Blob 本质上是传递给 Attribute 的构造函数。序列化格式与 C# 序列化格式相同。

对于GuidAttribute属性，二进制序列化格式为 20 字节：

01 00                                            Prolog (2-bytes)       0x0001 ==> version 1
1D 22 30 CA D9 86 FB 40 A2 6B D4 4E B7 CF 08 EA  Guid (16-bytes)        "CA30221D-86D9-40FB-A26B-D44EB7CF08EA"
00 00                                            Trailing null (2-bytes)

我提取 Guid 的最简单方法是声明一个匹配结构，将返回的指针转换为该结构的类型，然后访问Guid成员：

struct SerializedGuidAttribute
{
   UInt16 prolog; //2-bytes. 0x0001 
   Guid   guid;   //16-byte guid
   UInt16 footer; //2-byte footer
}
typedef SerializedGuidAttribute* PSerializedGuidAttribute;

Guid guidAttriute = PSerializedGuidAttribute(blob).guid;

你有它

Guid GetGuidAttribute(IMetadataReader reader, mdToken intf)
{
   Pointer blob;
   UInt32 blobLen;
   reader.GetCustomAttributeByName(intf, "Windows.Foundation.Metadata.GuidAttribute", 
         out blob, out blobLen);

   //if (blobLen != 20) { throw new Exception("Something") };

   return PSerializedGuidAttribute(blob).guid;
}

奖金

  • 微软元数据 API 文档
    • 2000 年 9 月 8 日：.docx
    • 2001 年 8 月 2 日：.pdf
于 2019-02-22T03:21:31.783 回答