Compartilhar via


Função Storage_GetAbsolutePathInImagePackage

Cabeçalho: #include <applibs/storage.h>

Obtém uma cadeia de caracteres terminada nulo que contém o caminho absoluto para um local dentro do pacote de imagem do aplicativo em execução, dado um caminho relativo dentro do pacote de imagem.

O local do pacote de imagem e o caminho retornado por essa função não serão alterados enquanto um aplicativo estiver em execução. No entanto, o local pode ser alterado entre execuções de um aplicativo.

Essa função aloca memória para a cadeia de caracteres retornada, que deve ser liberada pelo chamador usando free().

Essa função não marcar se o caminho existe no pacote de imagem. O caminho não pode começar com '/' ou '.' e não pode conter '.'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parâmetros

  • relativePath Um caminho relativo da raiz do pacote de imagem. Esse valor não deve começar com o caractere separador de diretório '/'.

Erros

Retorna NULL se um erro for encontrado e definir errno como o valor do erro.

  • EINVAL: relativePath começa com '/' ou '.', ou contém '..'.

  • EFAULT: relativePath é NULL.

  • ENOMEM: Sem memória.

Qualquer outro errno também pode ser especificado; esses erros não são determinísticos e o mesmo comportamento pode não ser mantido por meio de atualizações do sistema.

Valor retornado

Retorna o caminho absoluto que inclui a raiz do pacote de imagem ou NULL no erro, nesse caso errno é definido como o valor do erro.

Conceitos e exemplos