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, optional]

類型: 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 或 MrmCreateResourceFile 或 MrmCreateResourceFileInMemory (參數的MrmPackagingOptionsOmitSchemaFromResourcePacks參數所建立的資源套件) 。 若要傾印無架構資源套件,請將路徑傳遞至主要套件 PRI 資料做為 schemaPriFile 參數的引數。

規格需求

需求
最低支援的用戶端
Windows 10版本 1803 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server [僅限傳統型應用程式]
標頭
MrmResourceIndexer.h
程式庫
Mrmsupport.lib
DLL
Mrmsupport.dll

另請參閱

套件資源索引 (PRI) API 和自訂建置系統