MrmDumpPriFileInMemory-Funktion

[Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.]

Gibt eine PRI-Datei (binär) in der 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 auf, um diesen Arbeitsspeicher frei zu geben. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter APIs für die Paketressourcenindizierung 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-Speicherabbild sein soll oder ob ein Schema gedumpt 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 auf, um diesen Arbeitsspeicher frei zu geben.

outputXmlSize [ out]

Typ: ULONG *

Die Adresse eines ULONG. In outputXmlSize gibt die Funktion die Größe des zugeordneten Arbeitsspeichers zurück, auf den outputXmlData zeigt.

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 den Erfolg oder Fehler zu bestimmen.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10, version 1803 desktop apps only (Nur [ Desktop-Apps der Version 1803)]
Unterstützte Mindestversion (Server)
Windows Nur [ Serverdesktop-Apps]
Header
MrmResourceIndexer.h
Bibliothek
Mrmsupport.lib
DLL
Mrmsupport.dll

Siehe auch

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