Função MrmIndexEmbeddedData

[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 único recurso embeddeddata 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 MrmIndexEmbeddedData(
  _In_           MrmResourceIndexerHandle indexer,
  _In_           PCWSTR                   resourceUri,
  _In_     const BYTE                     *embeddedData,
  _In_           ULONG                    embeddedDataSize,
  _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.

embeddedData [in]

Tipo: const BYTE*

Um ponteiro para os dados do recurso que você deseja indexar.

embeddedDataSize [in]

Tipo: ULONG

O tamanho dos dados apontados por embeddedData.

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 do resourceUri.

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 do resourceUri.

O segmento de nome de arquivo de resourceUri é 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