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
);
参数
-
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 () 宏 (确定成功或失败。
备注
无架构资源包是使用 MrmPackagingOptionsOmitSchemaFromResourcePacks 参数传递给 MrmCreateResourceFile 或 MrmCreateResourceFileInMemory (或使用 pri 配置文件) 中的 omitSchemaFromResourcePacks 开关创建的资源包。 若要转储无架构的资源包,请将main包 PRI 数据的路径作为 schemaPriFile 参数的参数传递。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 10版本 1803 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|