Fungsi MrmDumpPriDataInMemory

[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 info PRI (sebagai blob dalam memori, yang dibuat oleh panggilan sebelumnya ke MrmCreateResourceFileInMemory) ke XML yang setara (sebagai data dalam memori), untuk membuatnya 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 MrmDumpPriDataInMemory(
  _In_     BYTE        *inputPriData,
  _In_     ULONG       inputPriSize,
  _In_opt_ BYTE        *schemaPriData,
  _In_     ULONG       schemaPriSize,
  _In_     MrmDumpType dumpType,
  _Out_    BYTE        **outputXmlData,
  _Out_    ULONG       *outputXmlSize
);

Parameter

inputPriData [in]

Jenis: BYTE*

Pointer ke data PRI yang dibuat oleh panggilan sebelumnya ke MrmCreateResourceFileInMemory.

inputPriSize [in]

Jenis: ULONG

Ukuran data yang ditujukkan oleh inputPriData.

schemaPriData [in, opsional]

Jenis: BYTE*

Penunjuk opsional ke info PRI (sebagai blob dalam memori) yang mewakili data skema yang dibuat oleh panggilan sebelumnya ke MrmCreateResourceFileInMemory. Jangan gratiskan skemaPriData hingga Anda selesai menggunakan pengindeks sumber daya. Lihat juga Keterangan.

schemaPriSize [in]

Jenis: ULONG

Ukuran data yang ditujukkan oleh schemaPriData.

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 schemaPriData .

Persyaratan

Lihat juga

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