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

Indiziert eine einzelne embeddeddata-Ressource , die zu einer UWP-App gehört. Verwendet eine explizite (aber optionale) Liste von Ressourcenqualifizierern. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter Paketressourcenindizierungs-APIs (PRI) und benutzerdefinierte Buildsysteme.

Syntax

HRESULT HRESULT MrmIndexEmbeddedData(
  _In_           MrmResourceIndexerHandle indexer,
  _In_           PCWSTR                   resourceUri,
  _In_     const BYTE                     *embeddedData,
  _In_           ULONG                    embeddedDataSize,
  _In_opt_       PCWSTR                   qualifiers
);

Parameter

Indexer [in]

Typ: MrmResourceIndexerHandle

Ein Handle, das den Ressourcenindexer identifiziert, der die Ressourcendatei indiziert.

resourceUri [in]

Typ: PCWSTR

Der Ressourcen-URI, der der Ressource zugewiesen werden soll. Der Pfad wird als Name der Ressourcenzuordnungsunterstruktur für diese Ressource verwendet, wenn Sie später eine PRI-Datei aus diesem Ressourcenindexer generieren.

embeddedData [in]

Typ: const BYTE*

Ein Zeiger auf die Daten der Ressource, die Sie indizieren möchten.

embeddedDataSize [in]

Typ: ULONG

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

Qualifizierer [in, optional]

Typ: PCWSTR

Eine optionale Liste von Ressourcenqualifizierern, z. B. L"language-en-US_scale-100_contrast-standard". Eine leere Zeichenfolge oder nullptr gibt eine neutrale Ressource an. Ressourcenqualifizierer werden nicht aus resourceUri abgeleitet.

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 Ressourcenqualifizierer angeben möchten, übergeben Sie sie im Qualifiziererparameter . Ressourcenqualifizierer werden nicht aus resourceUri abgeleitet.

Das Dateinamensegment von resourceUri wird als Ressourcenname verwendet.

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

Weitere Informationen

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

Freigeben über