Freigeben über


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.

Konzepte und Beispiele