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 [僅限傳統型應用程式] |
標頭 |
|
程式庫 |
|
DLL |
|