MrmDumpPriDataInMemory 函数

  • 项目

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

将 PRI 信息 (转储为内存中的 blob，由先前调用 MrmCreateResourceFileInMemory 创建，) 到其 XML 等效 (作为内存中数据) ，使其更易于阅读。 函数分配内存并返回 指向 outputXmlData 中该内存的指针。 使用同一指针调用 MrmFreeMemory 以释放该内存。 有关如何使用这些 API 的详细信息和基于方案的演练，请参阅 将资源索引打包 (PRI) API 和自定义生成系统。

语法

HRESULT HRESULT MrmDumpPriDataInMemory(
  _In_     BYTE        *inputPriData,
  _In_     ULONG       inputPriSize,
  _In_opt_ BYTE        *schemaPriData,
  _In_     ULONG       schemaPriSize,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

parameters

inputPriData [in]

类型： BYTE*

指向先前调用 MrmCreateResourceFileInMemory 创建的 PRI 数据的指针。

inputPriSize [in]

类型： ULONG

inputPriData 指向的数据大小。

schemaPriData [in， optional]

类型： BYTE*

指向 PRI 信息的可选指针 (为内存中的 blob) 表示先前调用 MrmCreateResourceFileInMemory 创建的架构数据。 直到使用完资源索引器后，才释放 schemaPriData 。 另请参阅备注。

schemaPriSize [in]

类型： ULONG

schemaPriData 指向的数据大小。

dumpType [in]

类型： MrmDumpType

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

outputXmlData [out]

类型： BYTE**

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

outputXmlSize [out]

类型： ULONG*

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

返回值

类型： HRESULT

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

备注

无架构资源包是使用 MrmPackagingOptionsOmitSchemaFromResourcePacks 参数传递给 MrmCreateResourceFile 或 MrmCreateResourceFileInMemory (或使用 pri 配置文件) 中的 omitSchemaFromResourcePacks 开关创建的资源包。 若要转储无架构的资源包，请将main包 PRI 数据的路径作为 schemaPriData 参数的参数传递。

要求

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

另请参阅

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