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

Erstellt neue, initialisierte PRI-Konfigurationsinformationen (als In-Memory-Daten, nicht als Datei), die die von Ihnen angegebenen Standardeinstellungen für den Qualifizierer definieren. 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 freizugeben. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter Paketressourcenindizierungs-APIs (PRI) und benutzerdefinierte Buildsysteme.

Syntax

HRESULT HRESULT MrmCreateConfigInMemory(
  _In_     MrmPlatformVersion platformVersion,
  _In_opt_ PCWSTR             defaultQualifiers,
  _Out_    BYTE               **outputXmlData,
  _Out_    ULONG              *outputXmlSize
);

Parameter

platformVersion [in]

Typ: MrmPlatformVersion

Die Plattformversion (targetOsVersion), die für die generierten Konfigurationsinformationen verwendet werden soll.

defaultQualifiers [in, optional]

Typ: PCWSTR

Eine Liste der Standardressourcenqualifizierer. Beispiel: L"language-en-US_scale-100_contrast-standard"

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 Arbeitsspeicher freizugeben.

outputXmlSize [out]

Typ: ULONG*

Die Adresse einer ULONG. In outputXmlSize gibt die Funktion die Größe des zugeordneten Speichers zurück, auf den outputXmlData 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.

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