Storage_GetAbsolutePathInImagePackage函数

标头: #include <applibs/storage.h>

获取一个以 null 结尾的字符串,该字符串包含正在运行的应用程序的映像包内某个位置的绝对路径,给定映像包内的相对路径。

应用程序运行时,映像包的位置和此函数返回的路径不会更改。 但是,在应用程序执行之间,位置可能会更改。

此函数为返回的字符串分配内存,调用方应使用 free () 释放该内存。

此函数不会检查映像包中是否存在路径。 路径不能以“/”或“.”开头,也不能包含“..”。

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

参数

  • relativePath 映像包根目录中的相对路径。 此值不得以目录分隔符“/”开头。

错误

如果遇到错误并设置为 errno 错误值,则返回 NULL。

  • EINVAL: relativePath 以“/”或“.”开头,或包含“..”。

  • EFAULT: relativePath 为 NULL。

  • ENOMEM:内存不足。

还可以指定任何其他 errno 错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。

返回值

返回包含映像包根目录的绝对路径,或错误时为 NULL,在这种情况下 errno ,设置为错误值。

概念和示例