Delen via

Storage_GetAbsolutePathInImagePackage functie

  • Artikel

Header: #include <applibs/storage.h>

Hiermee wordt een tekenreeks opgehaald die het absolute pad naar een locatie in het installatiekopieënpakket van de actieve toepassing bevat, op basis van een relatief pad in het installatiekopieënpakket.

De locatie van het installatiekopieënpakket en het pad dat door deze functie wordt geretourneerd, worden niet gewijzigd terwijl een toepassing wordt uitgevoerd. De locatie kan echter veranderen tussen uitvoeringen van een toepassing.

Met deze functie wordt geheugen toegewezen voor de geretourneerde tekenreeks, die door de aanroeper moet worden vrijgemaakt met behulp van free().

Met deze functie wordt niet gecontroleerd of het pad bestaat in het installatiekopieënpakket. Het pad kan niet beginnen met '/' of '.' en mag geen '..' bevatten.

char *Storage_GetAbsolutePathInImagePackage(const char *relativePath);

Parameters

  • relativePath Een relatief pad van de hoofdmap van het installatiekopieënpakket. Deze waarde mag niet beginnen met het adreslijstscheidingsteken '/'.

Fouten

Retourneert NULL als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EINVAL: relativePath begint met '/' of '.', of bevat '..'.

  • EFAULT: relativePath is NULL.

  • ENOMEM: Onvoldoende geheugen.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en hetzelfde gedrag wordt mogelijk niet bewaard via systeemupdates.

Retourwaarde

Retourneert het absolute pad dat de hoofdmap van het installatiekopieënpakket bevat, of NULL bij fout, in welk geval errno is ingesteld op de foutwaarde.

Concepten en voorbeelden