Partilhar via


Função Storage_OpenMutableFile

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

Obtém um descritor de ficheiros para o ficheiro de armazenamento mutável da aplicação. Se a aplicação ainda não tiver um ficheiro de armazenamento mutável, esta função cria um ficheiro e, em seguida, devolve o descritor de ficheiros.

Um ficheiro de armazenamento mutável armazena e mantém os dados durante um reinício do dispositivo ou atualização do sistema.

int Storage_OpenMutableFile(void);

Erros

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

  • EACCES: a aplicação não tem a capacidade de manifesto de aplicação necessária (MutableStorage).

  • EIO: Ocorreu um erro ao tentar criar o ficheiro.

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 um descritor de ficheiros ao ficheiro de armazenamento mutável; ou -1 para a falha, caso errno em que está definido como o erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade MutableStorage.

Conceitos e exemplos