Funzione Storage_GetAbsolutePathInImagePackageStorage_GetAbsolutePathInImagePackage Function

Intestazione: #include <applibs/storage.h>Header: #include <applibs/storage.h>

Ottiene una stringa con terminazione null che contiene il percorso completo in una posizione all'interno del pacchetto di immagine dell'applicazione in esecuzione, dato un percorso relativo all'interno del pacchetto di immagine.Gets a null-terminated string that contains the absolute path to a location within the image package of the running application, given a relative path inside the image package.

La posizione del pacchetto di immagine e il percorso restituito da questa funzione non verranno modificati durante l'esecuzione di un'applicazione.The location of the image package and the path returned by this function will not change while an application is running. Tuttavia, il percorso può variare tra le esecuzioni di un'applicazione.However, the location may change between executions of an application.

Questa funzione alloca memoria per la stringa restituita, che deve essere liberata dal chiamante mediante Free().This function allocates memory for the returned string, which should be freed by the caller using free().

Questa funzione non controlla se il percorso esiste nel pacchetto di immagine.This function does not check whether the path exists in the image package. Il percorso non può iniziare con “/” o “.” e non può contenere “..”.The path cannot not begin with '/' or '.', and cannot not contain '..'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

ParametriParameters

  • relativePath Un percorso relativo dalla radice del pacchetto di immagine.relativePath A relative path from the root of the image package. Questo valore non deve iniziare con il carattere separatore di directory “/”.This value must not start with the directory separator character '/'.

ErrorsErrors

Restituisce NULL se viene rilevato un errore e imposta sul errno valore di errore.Returns NULL if an error is encountered and sets errno to the error value.

  • EINVAL: relativePath inizia con '/' o '.' oppure contiene '..'.EINVAL: relativePath begins with '/' or '.', or contains '..'.

  • EFAULT: relativePath è NULL.EFAULT: relativePath is NULL.

  • ENOMEM: Memoria esaurita.ENOMEM: Out of memory.

errnoÈ possibile specificare anche qualsiasi altro tipo di errore. tali errori non sono deterministici e lo stesso comportamento potrebbe non essere mantenuto tramite gli aggiornamenti del sistema.Any other errno may also be specified; such errors aren't deterministic and the same behavior might not be retained through system updates.

Valore restituitoReturn value

Restituisce il percorso assoluto che include la radice del pacchetto immagine o NULL in caso di errore, nel qual caso errno viene impostato sul valore di errore.Returns the absolute path that includes the image package root, or NULL on error, in which case errno is set to the error value.

Concetti ed esempiConcepts and samples