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

Indiziert eine Ressourcendatei, die zu einer UWP-App gehört. Nimmt eine explizite (aber optionale) Liste von Ressourcenqualifizierern an. Weitere Informationen und szenariobasierte exemplarische Vorgehensweisen zur Verwendung dieser APIs finden Sie unter APIs für die Paketressourcenindizierung (PACKAGE Resource Indexing, PRI) und benutzerdefinierte Buildsysteme.

Syntax

HRESULT HRESULT MrmIndexFile(
  _In_     MrmResourceIndexerHandle indexer,
  _In_     PCWSTR                   resourceUri,
  _In_     PCWSTR                   filePath,
  _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.

filePath [ In]

Typ: PCWSTR

Ein relativer Pfad zu einer Datei, die eine Ressource enthält, die Sie indizieren möchten. Dieser Pfad ist relativ zum Projektstamm der UWP-App, für die Sie PRI-Dateien generieren. Dieser Projektstamm ist der Wert von projectRoot, den Sie an MrmCreateResourceIndexerübergeben haben.

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 weder von resourceUri noch von containerPath abgeleitet.

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 fehlerbestimmend zu sein.

Hinweise

Wenn Sie Ressourcenqualifizierer angeben möchten, übergeben Sie sie im Qualifiziererparameter. Ressourcenqualifizierer werden weder von resourceUri noch von filePath abgeleitet.

Das Dateinamensegment von resourceUri (nicht filePath) wird als Ressourcenname verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 10, nur Desktop-Apps der Version 1803 []
Unterstützte Mindestversion (Server)
Windows [Nur Serverdesktop-Apps]
Header
MrmResourceIndexer.h
Bibliothek
Mrmsupport.lib
DLL
Mrmsupport.dll

Weitere Informationen

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