Storage_OpenFileInImagePackage 函数

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

获取映像包中的相对路径,并返回打开的只读文件描述符。 调用方应使用 close 函数关闭返回的文件描述符。 此函数应仅用于打开映像包中的常规文件。

int Storage_OpenFileInImagePackage(const char *relativePath);

参数

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

错误

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

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

  • EFAULT: relativePath 为 NULL。

  • ENOMEM:内存不足。

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

返回值

返回打开的文件描述符,如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

概念和示例