Partager via


Fonction MrmIndexFile

[Certaines informations portent sur la préversion du produit, qui est susceptible d’être en grande partie modifié avant sa commercialisation. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.]

Indexe un fichier de ressources appartenant à une application UWP. Prend une liste explicite (mais facultative) de qualificateurs de ressources. Pour plus d’informations et des procédures pas à pas basées sur des scénarios sur l’utilisation de ces API, consultez API d’indexation des ressources de package (PRI) et systèmes de génération personnalisés.

Syntaxe

HRESULT HRESULT MrmIndexFile(
  _In_     MrmResourceIndexerHandle indexer,
  _In_     PCWSTR                   resourceUri,
  _In_     PCWSTR                   filePath,
  _In_opt_ PCWSTR                   qualifiers
);

Paramètres

indexeur [in]

Type : MrmResourceIndexerHandle

Handle identifiant l’indexeur de ressources qui indexera le fichier de ressources.

resourceUri [in]

Type : PCWSTR

URI de ressource à affecter à la ressource. Le chemin d’accès sera utilisé comme nom de sous-arborescence de mappage de ressources pour cette ressource lorsque vous générerez ultérieurement un fichier PRI à partir de cet indexeur de ressources.

filePath [in]

Type : PCWSTR

Chemin d’accès relatif à un fichier contenant une ressource que vous souhaitez indexer. Ce chemin est relatif à la racine du projet de l’application UWP pour laquelle vous générez des fichiers PRI. Cette racine de projet est la valeur de projectRoot que vous avez transmise à MrmCreateResourceIndexer.

qualificateurs [in, facultatif]

Type : PCWSTR

Liste facultative de qualificateurs de ressources, par exemple L"language-en-US_scale-100_contrast-standard ». Une chaîne vide ou nullptr indique une ressource neutre. Les qualificateurs de ressources ne sont pas déduits de resourceUri ni de containerPath.

Valeur retournée

Type : HRESULT

S_OK si la fonction a réussi, sinon une autre valeur. Utilisez les macros SUCCEEDED() ou FAILED() (définies dans winerror.h) pour déterminer la réussite ou l’échec.

Notes

Si vous souhaitez spécifier des qualificateurs de ressources, passez-les dans le paramètre qualificateurs . Les qualificateurs de ressources ne sont pas déduits de resourceUri ni de filePath.

Le segment de nom de fichier de resourceUri (et non filePath) est utilisé comme nom de ressource.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 10, version 1803 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server [applications de bureau uniquement]
En-tête
MrmResourceIndexer.h
Bibliothèque
Mrmsupport.lib
DLL
Mrmsupport.dll

Voir aussi

API d’indexation de ressources de package (IRP) et systèmes de génération personnalisés