共用方式為


Storage_GetAbsolutePathInImagePackage函數

頁首: #include < applibs/storage。h>

取得包含執行應用程式之圖像套件內位置絕對路徑的 Null 終止字串,指定影像套件內的相對路徑。

當應用程式正在執行時,圖像套件的位置以及此函數傳回的路徑不會變更。 不過,應用程式執行之間可能會變更位置。

此函數會配置傳回字串的記憶體,應由來電者使用免費 () 釋放。

此函數不會檢查路徑是否存在於圖像套件中。 路徑不能以 '/' 或 '.' 開頭,也不能包含 '..'。

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

參數

  • relativePath 影像套件根目錄的相對路徑。 此值不得以目錄分隔符號 '/'開頭。

錯誤

如果發生錯誤,並設定為 errno 錯誤值,則傳回 Null。

  • EINVAL: relativePath 開頭為 '/' 或 '.',或包含 '..'。

  • EFAULT: relativePath 為 Null。

  • ENOMEM:記憶體不足。

您也可以指定任何其他 errno 錯誤;這類錯誤不是不確定的,同樣的行為可能無法透過系統更新來保留。

傳回值

傳回包含圖像封裝根或錯誤時 Null 的絕對路徑,在這種情況下 errno 會設定為錯誤值。

概念和範例