Partilhar via


Função Storage_OpenFileInImagePackage

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

Utiliza um caminho relativo dentro do pacote de imagem e devolve um descritor de ficheiro só de leitura aberto. O autor da chamada deve fechar o descritor de ficheiro devolvido com a função close. Esta função só deve ser utilizada para abrir ficheiros normais dentro do pacote de imagem.

int Storage_OpenFileInImagePackage(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 -1 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 descritor de ficheiro aberto ou -1 para a falha, caso errno em que está definido como o valor de erro.

Conceitos e exemplos