MrmIndexFile-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.]
Indiziert eine Ressourcendatei, 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 MrmIndexFile(
_In_ MrmResourceIndexerHandle indexer,
_In_ PCWSTR resourceUri,
_In_ PCWSTR filePath,
_In_opt_ PCWSTR qualifiers
);
Parameter
-
Indexer [in]
-
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 aus resourceUri noch aus containerPath 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 weder aus resourceUri noch aus filePath abgeleitet.
Das Dateinamensegment von resourceUri (nicht filePath) 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 |
|
| Bibliothek |
|
| DLL |
|