funkce Storage_GetAbsolutePathInImagePackage
Hlavička: #include <applibs/storage.h>
Získá řetězec s ukončenou hodnotou null, který obsahuje absolutní cestu k umístění v rámci balíčku bitové kopie spuštěné aplikace, vzhledem k relativní cestě uvnitř balíčku image.
Umístění balíčku image a cesta vrácená touto funkcí se za běhu aplikace nezmění. Umístění se však může mezi spuštěními aplikace změnit.
Tato funkce přidělí vrácenému řetězci paměť, kterou by měl volající uvolnit pomocí funkce free().
Tato funkce nekontroluje, jestli cesta existuje v balíčku image. Cesta nemůže začínat na '/' nebo '.' a nemůže obsahovat ...
char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);
Parametry
-
relativePath
Relativní cesta z kořenového adresáře balíčku image. Tato hodnota nesmí začínat znakem oddělovače adresáře '/'.
Chyby
Vrátí hodnotu NULL, pokud dojde k chybě, a nastaví errno
se na chybovou hodnotu.
EINVAL:
relativePath
začíná na '/' nebo '.', nebo obsahuje ...EFAULT:
relativePath
má hodnotu NULL.ENOMEM: Nedostatek paměti.
Je také možné zadat všechny ostatní errno
chyby. Tyto chyby nejsou deterministické a stejné chování nemusí být zachováno prostřednictvím aktualizací systému.
Vrácená hodnota
Vrátí absolutní cestu, která zahrnuje kořen balíčku obrázku, nebo NULL při chybě, v takovém případě errno
je nastavena na chybovou hodnotu.