MrmCreateResourceFileInMemory-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.]

Erstellt PRI-Informationen als Blob im Arbeitsspeicher, nicht als Datei auf dem Datenträger. Die Funktion ordnet Arbeitsspeicher zu und gibt einen Zeiger auf diesen Arbeitsspeicher in outputPriData zurück. Rufen Sie MrmFreeMemory mit demselben Zeiger auf, um diesen Arbeitsspeicher freizugeben. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter Paketressourcenindizierungs-APIs (PRI) und benutzerdefinierte Buildsysteme.

Syntax

HRESULT HRESULT MrmCreateResourceFileInMemory(
  _In_  MrmResourceIndexerHandle indexer,
  _In_  MrmPackagingMode         packagingMode,
  _In_  MrmPackagingOptions      packagingOptions,
  _Out_ BYTE                     **outputPriData,
  _Out_ ULONG                    *outputPriSize
);

Parameter

Indexer [in]

Typ: MrmResourceIndexerHandle

Ein Handle, das den Ressourcenindexer identifiziert, aus dem die PRI-Informationen erstellt werden sollen.

packagingMode [in]

Typ: MrmPackagingMode

Gibt an, ob die PRI-Informationen eigenständig oder ein Ressourcenpaket sein sollen. MrmPackagingModeAutoSplit wird nicht unterstützt.

packagingOptions [in]

Typ: MrmPackagingOptions

Gibt zusätzliche Optionen zu den PRI-Informationen an.

outputPriData [out]

Typ: BYTE**

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

outputPriSize [out]

Typ: ULONG*

Die Adresse einer ULONG. In outputPriSize gibt die Funktion die Größe des zugeordneten Speichers zurück, auf den outputPriData verweist.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Wenn Sie outputPriData an MrmCreateResourceIndexerFromPreviousPriData übergeben, geben Sie den Arbeitsspeicher erst frei, nachdem Sie den Ressourcenindexer verwendet haben.

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