Partilhar via

Função Storage_GetAbsolutePathInImagePackage

  • Artigo

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

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

A localização do pacote de imagem e o caminho devolvido por esta função não serão alterados enquanto uma aplicação estiver em execução. No entanto, a localização pode mudar entre execuções de uma aplicação.

Esta função aloca memória para a cadeia devolvida, que deve ser libertada pelo autor da chamada utilizando free().

Esta função não verifica 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. Este valor não pode começar com o caráter de separador de diretório '/'.

Erros

Devolve NULL se for encontrado um erro e define errno para o valor de erro.

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

  • EFAULT: relativePath é NULL.

  • ENOMEM: memória insuficiente.

Também pode ser especificado qualquer outro errno ; esses erros não são deterministas e o mesmo comportamento pode não ser retido através de atualizações do sistema.

Valor devolvido

Devolve o caminho absoluto que inclui a raiz do pacote de imagem ou NULO no erro, caso errno em que está definido como o valor de erro.

Conceitos e exemplos