MrmDumpPriFileInMemory-Funktion

Artikel
06/13/2023

[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]

Gibt eine PRI-Datei (die binär ist) in ihre XML-Entsprechung (als In-Memory-Daten) ab, um sie leichter lesbar zu machen. Die Funktion weist Arbeitsspeicher zu und gibt einen Zeiger auf diesen Arbeitsspeicher in outputXmlData zurück. Rufen Sie MrmFreeMemory mit demselben Zeiger an, um diesen Speicher freizugeben. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter Paketressourcenindizierungs-APIs (PRI) und benutzerdefinierte Buildsysteme.

Syntax

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

Parameter

indexFileName [in]

Typ: PCWSTR

Ein vollständiger Dateipfad zu einer PRI-Datei. Dies ist die PRI-Datei, die in XML gespeichert wird.

schemaPriFile [in, optional]

Typ: PCWSTR

Ein optionaler vollständiger Dateipfad zu einer Schemadatei (oder zu einer PRI-Datei, die ein Schema darstellt; siehe Hinweise).

dumpType [in]

Typ: MrmDumpType

Gibt an, wie detailliert das XML-Abbild sein soll oder ob ein Schema mit Einem Dump versehen werden soll.

outputXmlData [out]

Typ: BYTE**

Die Adresse eines Zeigers auf BYTE. Die Funktion weist Arbeitsspeicher zu und gibt einen Zeiger auf diesen Arbeitsspeicher in outputXmlData zurück. Rufen Sie MrmFreeMemory mit Ihrem Zeiger auf BYTE an, um diesen Speicher freizugeben.

outputXmlSize [out]

Typ: ULONG*

Die Adresse einer ULONG. In outputXmlSize gibt die Funktion die Größe des zugeordneten Arbeitsspeichers zurück, auf den von outputXmlData verwiesen wird.

Rückgabewert

Typ: HRESULT

S_OK, wenn die Funktion erfolgreich war, andernfalls ein anderer Wert. Verwenden Sie die Makros SUCCEEDED() oder FAILED() (definiert in winerror.h), um Erfolg oder Fehler zu bestimmen.

Bemerkungen

Ein schemafreies Ressourcenpaket wurde mit dem Argument MrmPackagingOptionsOmitSchemaFromResourcePacks erstellt, das an MrmCreateResourceFile oder MrmCreateResourceFileInMemory übergeben wurde (oder mit dem Schalter omitSchemaFromResourcePacks in der PRI-Konfigurationsdatei). Um ein schemafreies Ressourcenpaket abzuspeichern, übergeben Sie den Pfad zu Ihren Standard Paket-PRI-Daten als Argument für den schemaPriFile-Parameter.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Header	MrmResourceIndexer.h
Bibliothek	Mrmsupport.lib
DLL	Mrmsupport.dll

Siehe auch

APIs für die Paketressourcenindizierung (PRI) und benutzerdefinierte Buildsysteme

Freigeben über