Função MrmIndexFile

[Algumas informações relacionam-se ao produto de pré-lançamento, o qual poderá ser substancialmente modificado antes do lançamento comercial. A Microsoft não fornece nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.]

Indexa um arquivo de recurso pertencente a um aplicativo UWP. Usa uma lista explícita (mas opcional) de qualificadores de recursos. Para obter mais informações e instruções passo a passo baseadas em cenários de como usar essas APIs, consulte APIs pri (indexação de recursos de pacote) e sistemas de build personalizados.

Sintaxe

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

Parâmetros

indexador [in]

Tipo: MrmResourceIndexerHandle

Um identificador que identifica o indexador de recursos que indexará o arquivo de recurso.

resourceUri [in]

Tipo: PCWSTR

O URI do recurso a ser atribuído ao recurso. O caminho será usado como o nome da subárvore do mapa de recursos para esse recurso quando você gerar posteriormente um arquivo PRI desse indexador de recursos.

filePath [in]

Tipo: PCWSTR

Um caminho relativo para um arquivo que contém um recurso que você deseja indexar. Esse caminho é relativo à raiz do projeto do aplicativo UWP para o qual você está gerando arquivos PRI. Essa raiz do projeto é o valor de projectRoot que você passou para MrmCreateResourceIndexer.

qualificadores [in, opcional]

Tipo: PCWSTR

Uma lista opcional de qualificadores de recursos, por exemplo, L"language-en-US_scale-100_contrast-standard". Uma cadeia de caracteres vazia ou nullptr indica um recurso neutro. Os qualificadores de recursos não são inferidos de resourceUri nem de containerPath.

Valor retornado

Tipo: HRESULT

S_OK se a função foi bem-sucedida, caso contrário, algum outro valor. Use as macros SUCCEEDED() ou FAILED() (definidas em winerror.h) para determinar o êxito ou a falha.

Comentários

Se você quiser especificar qualquer qualificador de recurso, passe-os no parâmetro qualificadores . Os qualificadores de recursos não são inferidos de resourceUri nem de filePath.

O segmento de nome de arquivo de resourceUri (não filePath) é usado como o nome do recurso.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1803 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server [somente aplicativos da área de trabalho]
Cabeçalho	MrmResourceIndexer.h
Biblioteca	Mrmsupport.lib
DLL	Mrmsupport.dll

Confira também

APIs de PRI (índice de recurso do pacote) e sistemas de build personalizados