Storage_OpenFileInImagePackage-Funktion
Header: #include <applibs/storage.h>
Verwendet einen relativen Pfad innerhalb des Bildpakets und gibt einen geöffneten schreibgeschützten Dateideskriptor zurück. Der Aufrufer sollte den zurückgegebenen Dateideskriptor mit der Close-Funktion schließen. Diese Funktion sollte nur verwendet werden, um reguläre Dateien innerhalb des Imagepakets zu öffnen.
int Storage_OpenFileInImagePackage(const char *relativePath);
Parameter
-
relativePath
Ein relativer Pfad vom Stamm des Imagepakets. Dieser Wert darf nicht mit dem Verzeichnistrennzeichen "/" beginnen.
Fehler
Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno
.
EINVAL:
relativePath
beginnt mit '/' oder '.' oder enthält '.'.EFAULT:
relativePath
ist NULL.ENOMEM: Nicht genügend Arbeitsspeicher.
Auch andere errno
Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und dasselbe Verhalten wird möglicherweise nicht durch Systemupdates beibehalten.
Rückgabewert
Gibt den geöffneten Dateideskriptor oder -1 für fehler zurück. In diesem Fall errno
wird auf den Fehlerwert festgelegt.