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 |
|
| Bibliothek |
|
| DLL |
|