Partager via

Storage_GetAbsolutePathInImagePackage, fonction

  • Article

En-tête : #include <applibs/storage.h>

Obtient une chaîne terminée par null qui contient le chemin d’accès absolu à un emplacement dans le package d’images de l’application en cours d’exécution, en fonction d’un chemin relatif à l’intérieur du package d’image.

L’emplacement du package d’image et le chemin retourné par cette fonction ne changent pas pendant l’exécution d’une application. Toutefois, l’emplacement peut changer entre les exécutions d’une application.

Cette fonction alloue de la mémoire pour la chaîne retournée, qui doit être libérée par l’appelant à l’aide de free().

Cette fonction n’case activée pas si le chemin existe dans le package d’images. Le chemin d’accès ne peut pas commencer par « / » ou « . » et ne peut pas contenir « .. ».

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Paramètres

  • relativePath Chemin d’accès relatif à partir de la racine du package d’image. Cette valeur ne doit pas commencer par le caractère de séparation de répertoire « / ».

Erreurs

Retourne NULL si une erreur est rencontrée et définit errno sur la valeur d’erreur.

  • EINVAL : relativePath commence par « / » ou « . », ou contient « .. ».

  • EFAULT : relativePath a la valeur NULL.

  • ENOMEM : Mémoire insuffisante.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et le même comportement peut ne pas être conservé par le biais des mises à jour système.

Valeur de retour

Retourne le chemin d’accès absolu qui inclut la racine du package d’image, ou NULL en cas d’erreur, auquel cas errno est défini sur la valeur d’erreur.

Concepts et exemples