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
會設定為錯誤值。