MrmDumpPriFileInMemory 函数

[一些信息与预发布产品相关,在商业发行之前可能发生实质性修改。 Microsoft 对于此处提供的信息不作任何明示或默示的担保。]

将 PRI 文件转储 (,该文件是二进制) ,其 XML 等效 (作为内存中的数据) ,以便更易于读取。 该函数分配内存,并返回指向 outputXmlData 中该内存的指针。 使用相同的指针调用 MrmFreeMemory 以释放该内存。 有关如何使用这些 API 的详细信息和基于方案的演练,请参阅 包资源索引 (PRI) API 和自定义生成系统

语法

HRESULT HRESULT MrmDumpPriFileInMemory(
  _In_     PCWSTR      indexFileName,
  _In_opt_ PCWSTR      schemaPriFile,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

parameters

indexFileName [in]

类型: PCWSTR

PRI 文件的完整文件路径。 这是将转储到 XML 的 PRI 文件。

schemaPriFile [in, 可选]

类型: PCWSTR

架构文件的可选完整文件路径 (或表示架构的 PRI 文件;请参阅备注) 。

dumpType [in]

类型: MrmDumpType

指定 XML 转储的详细程度,或是否应转储架构。

outputXmlData [out]

类型: BYTE**

指向 BYTE 的指针的地址。 该函数分配内存,并返回指向 outputXmlData 中该内存的指针。 使用指向 BYTE 的指针调用 MrmFreeMemory 以释放该内存。

outputXmlSize [out]

类型: ULONG*

ULONG 的地址。 在 outputXmlSize 中,该函数返回 outputXmlData 指向的已分配内存的大小。

返回值

类型: HRESULT

如果函数成功,则S_OK否则为其他一些值。 使用 winerror.h) 中定义的 SUCCEEDED () 或 FAILED () (宏来确定成功或失败。

注解

无架构资源包是使用传递给 MrmCreateResourceFile 或 MrmCreateResourceFileInMemory (的 MrmPackagingOptionsOmitSchemaFromResourcePacks 参数创建的,或者使用 PRI 配置文件) 中的省略SchemaFromResourcePacks 开关创建的。 若要转储无架构资源包,请将主包 PRI 数据的路径作为 schemaPriFile 参数的参数传递。

要求

要求
最低受支持的客户端
Windows 10版本 1803 [仅限桌面应用]
最低受支持的服务器
Windows服务器 [仅限桌面应用]
标头
MrmResourceIndexer.h

Mrmsupport.lib
DLL
Mrmsupport.dll

另请参阅

包资源索引 (PRI) API 和自定义生成系统