Compartir a través de

Función Storage_GetAbsolutePathInImagePackage

  • Artículo

Encabezado: #include <applibs/storage.h>

Obtiene una cadena terminada en null que contiene la ruta de acceso absoluta a una ubicación dentro del paquete de imagen de la aplicación en ejecución, dada una ruta de acceso relativa dentro del paquete de imagen.

La ubicación del paquete de imagen y la ruta de acceso devuelta por esta función no cambiarán mientras se esté ejecutando una aplicación. Sin embargo, la ubicación puede cambiar entre las ejecuciones de una aplicación.

Esta función asigna memoria para la cadena devuelta, que debe liberar el autor de la llamada mediante free().

Esta función no comprueba si la ruta de acceso existe en el paquete de imagen. La ruta de acceso no puede comenzar con '/' ni '.' y no puede contener '.'.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parámetros

  • relativePath Una ruta de acceso relativa de la raíz del paquete de imagen. Este valor no debe empezar por el carácter separador de directorio '/'.

Errores

Devuelve NULL si se encuentra un error y se establece errno en el valor de error.

  • EINVAL: relativePath comienza con '/' o '.', o contiene '.'.

  • EFAULT: relativePath es NULL.

  • ENOMEM: Fuera de la memoria.

También se pueden especificar otros errno errores; estos errores no son deterministas y es posible que no se conserve el mismo comportamiento a través de las actualizaciones del sistema.

Valor devuelto

Devuelve la ruta de acceso absoluta que incluye la raíz del paquete de imagen o NULL en error, en cuyo caso errno se establece en el valor de error.

Conceptos y ejemplos