Fungsi MrmDumpPriFileInMemory

Artikel
06/13/2023

[Beberapa informasi berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat atau tersirat, sehubungan dengan informasi yang diberikan di sini.]

Mencadangkan file PRI (yang merupakan biner) ke XML yang setara (sebagai data dalam memori), agar lebih mudah dibaca. Fungsi ini mengalokasikan memori dan mengembalikan pointer ke memori tersebut dalam outputXmlData. Panggil MrmFreeMemory dengan pointer yang sama untuk membebaskan memori tersebut. Untuk informasi selengkapnya, dan panduan berbasis skenario tentang cara menggunakan API ini, lihat API pengindeksan sumber daya paket (PRI) dan sistem build kustom.

Sintaks

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

Parameter

indexFileName [in]

Jenis: PCWSTR

Jalur file lengkap ke file PRI. Ini adalah file PRI yang akan dicadangkan ke XML.

schemaPriFile [in, opsional]

Jenis: PCWSTR

Jalur file lengkap opsional ke file skema (atau ke file PRI yang mewakili skema; lihat Komentar).

dumpType [in]

Jenis: MrmDumpType

Menentukan seberapa rinci cadangan XML harus, atau apakah skema harus dicadangkan.

outputXmlData [out]

Jenis: BYTE**

Alamat pointer ke BYTE. Fungsi ini mengalokasikan memori dan mengembalikan pointer ke memori tersebut dalam outputXmlData. Hubungi MrmFreeMemory dengan pointer Anda ke BYTE untuk membebaskan memori tersebut.

outputXmlSize [out]

Jenis: ULONG*

Alamat ULONG. Dalam outputXmlSize, fungsi mengembalikan ukuran memori yang dialokasikan yang dialokasikan yang ditujukan oleh outputXmlData.

Menampilkan nilai

Jenis: HRESULT

S_OK jika fungsi berhasil, jika tidak, beberapa nilai lainnya. Gunakan makro SUCCEEDED() atau FAILED() (ditentukan dalam winerror.h) untuk menentukan keberhasilan atau kegagalan.

Keterangan

Paket sumber daya bebas skema adalah paket yang dibuat dengan argumen MrmPackagingOptionsOmitSchemaFromResourcePacks yang diteruskan ke MrmCreateResourceFile atau MrmCreateResourceFileInMemory (atau dengan sakelar omitSchemaFromResourcePacks dalam file konfigurasi PRI). Untuk membuang paket sumber daya bebas skema, teruskan jalur ke data PRI paket utama Anda sebagai argumen untuk parameter schemaPriFile .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1803 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server [hanya aplikasi desktop]
Header	MrmResourceIndexer.h
Pustaka	Mrmsupport.lib
DLL	Mrmsupport.dll

Lihat juga

API pengindeksan sumber daya paket (PRI) dan sistem build kustom

Bagikan melalui