MrmDumpPriDataInMemory-Funktion

[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 PRI-Informationen (als Blob im Arbeitsspeicher, erstellt durch einen vorherigen Aufruf von MrmCreateResourceFileInMemory) 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 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]

Typ: BYTE*

Ein Zeiger auf PRI-Daten, die durch einen vorherigen Aufruf von MrmCreateResourceFileInMemory erstellt wurden.

inputPriSize [in]

Typ: ULONG

Die Größe der Daten, auf die von inputPriData verwiesen wird.

schemaPriData [in, optional]

Typ: BYTE*

Ein optionaler Zeiger auf PRI-Informationen (als Blob im Arbeitsspeicher), der Schemadaten darstellt, die durch einen vorherigen Aufruf von MrmCreateResourceFileInMemory erstellt wurden. Geben Sie schemaPriData erst frei, wenn Sie mit der Verwendung des Ressourcenindexers fertig sind. Siehe auch Hinweise.

schemaPriSize [in]

Typ: ULONG

Die Größe der Daten, auf die von schemaPriData verwiesen wird.

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