Share via

funkce Storage_GetAbsolutePathInImagePackage

  • Článek

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.

Koncepty a ukázky