Compartilhar via


Função MrmGetFilePathFromName (mrm.h)

Obtém o caminho padrão para um nome de arquivo.

Sintaxe

HRESULT MrmGetFilePathFromName(
  PCWSTR filename,
  PWSTR  *filePath
);

Parâmetros

filename

O nome do arquivo.

filePath

Conterá o caminho do arquivo se a chamada tiver sido bem-sucedida.

Valor de retorno

HRESULT que indica o resultado da operação.

Observações

Esse método procura primeiro no caminho do módulo atual um arquivo com o nome especificado (ou resources.pri se nenhum nome foi fornecido). Se esse arquivo existir, o parâmetro filePath será definido como o caminho completo desse arquivo.

Se nenhum arquivo foi encontrado na etapa anterior, esse método examinará o diretório pai do caminho do módulo atual para um arquivo com o nome especificado (ou [current module name].pri se nenhum nome tiver sido fornecido). Se esse arquivo existir, o parâmetro filePath será definido como o caminho completo desse arquivo.

Se nenhum dos arquivos existir, o parâmetro filePath será definido como [current module path]\[fileName], em que fileName usa como padrão resources.pri se nenhum nome de arquivo tiver sido especificado. Observe que esse arquivo pode não existir.

Aviso

MrmGetFilePathFromName sempre retornará um caminho para o sucesso. O caminho pode nem sempre existir.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 1809 (com o SDK do Windows App 0.5 ou posterior)
cabeçalho mrm.h