function DeleteFile [SWS_PER_00111] Upstream: RS_PER_00001, RS_PER_00004, RS_AP_00119, RS_AP_00120, RS_ AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00129, RS_AP_00135, RS_AP_00139, RS_AP_00159
ara::core::Result< void > DeleteFile (ara::core::StringView fileName) noexcept;
Deletes a file from this File Storage. This operation will fail with kResourceBusy when the file is currently open.
Die synchrone Methode DeleteFile der Klasse ara::per::FileStorage löscht eine Datei anhand ihres Namens (fileName) aus dem Dateispeicher [SWS_PER_00111]. Der Bezeichner kann dem konfigurierten PersistencyFile.fileName entsprechen [SWS_PER_00111]. Der Aufruf ist als noexcept spezifiziert, gilt als ausnahmesicher sowie threadsicher und meldet das Ergebnis über ara::core::Result<void> zurück [SWS_PER_00111].
Vor dem Aufruf müssen alle aktiven Zugriffe auf die Zieldatei beendet sein. Ist die Datei gegenwärtig geöffnet, schlägt der Löschvorgang mit dem Fehler PerErrc::kResourceBusy fehl [SWS_PER_00111]. Anwendungen müssen daher sicherstellen, dass zuvor über OpenFileReadWrite [SWS_PER_00113], OpenFileReadOnly [SWS_PER_00114] oder OpenFileWriteOnly [SWS_PER_00115] erzeugte UniqueHandle-Instanzen ihren Gültigkeitsbereich verlassen haben, wodurch die Datei geschlossen wird. Ebenso führt eine parallel laufende Ausführung von RecoverFile [SWS_PER_00337] oder ResetFile [SWS_PER_00338] für denselben Dateinamen zu PerErrc::kResourceBusy [SWS_PER_00111].
Im Fehlerfall stellt der zurückgegebene Result-Typ spezifische Fehlerursachen bereit [SWS_PER_00111]:
PerErrc::kFileNotFound: Die angegebene Datei existiert nicht im Dateispeicher [SWS_PER_00111].PerErrc::kIllegalWriteAccess: Der File Storage ist schreibgeschützt konfiguriert [SWS_PER_00111].PerErrc::kPhysicalStorageFailure: Der Zugriff auf das physische Speichermedium scheitert (ohne Rollback-Semantik) [SWS_PER_00111].PerErrc::kIntegrityCorrupted,PerErrc::kEncryptionFailedoderPerErrc::kAuthenticationFailed: Fehler bei struktureller Integrität, Ver-/Entschlüsselung oder MAC-Prüfung (jeweils mit Rollback-Semantik) sowie herstellerspezifische Fehler [SWS_PER_00111].
Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe. Verbindlich sind ausschließlich die Spezifikationen der AUTOSAR-Dokumentation.
Implementer's Guide folgt (Komplexität I2)
| Header-Datei | #include "ara/per/file_storage.h" |
|---|---|
| Scope | class ara::per::FileStorage |
| Exception-Sicherheit | exception safe |
| Thread-Sicherheit | thread-safe |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| fileName | File name of the file. May correspond to the PersistencyFile.file Name of a configured file. |
Rückgabewert
| Typ | Beschreibung |
|---|---|
| ara::core::Result< void > | A Result of void. In case of an error, it contains any of the errors defined below, or a vendor specific error. |
Fehler
| Fehlercode | Beschreibung |
|---|---|
| PerErrc::kIllegalWriteAccess | rollback_semantics Returned if the File Storage is configured as read-only. |
| PerErrc::kPhysicalStorageFailure | no_rollback_semantics Returned if access to the physical storage fails. |
| PerErrc::kIntegrityCorrupted | rollback_semantics Returned if stored data cannot be written because the structural integrity is corrupted. |
| PerErrc::kEncryptionFailed | rollback_semantics Returned if the encryption or decryption of stored data fails. |
| PerErrc::kResourceBusy | rollback_semantics Returned if the file is open, or if RecoverFile or ResetFile with the same file name is currently being executed. |
| PerErrc::kFileNotFound | rollback_semantics Returned if the provided file does not exist in the File Storage. |
| PerErrc::kAuthenticationFailed | rollback_semantics Returned if calculating or checking the MAC of stored data fails. |
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/SWS_PER_00111- Status
- valid/unmigrated
- Version
AUTOSAR/AP/record/SWS_PER_00111@rel:R25-11#9014bbf3- Content hash
9014bbf3- Source
- https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Persistency.pdf#nameddest=SWS_PER_00111
Status: valid/unmigrated
Version: rel:R25-11#54be3f24
Versionshistorie & Revisions (1 transition, 8 revision)
- Current State
valid/unmigrated- Reason
- mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
- Campaign
2026-08-13-status-backfill- Active Version
AUTOSAR/AP/record/SWS_PER_00111@rel:R25-11#54be3f24
Recorded Revisions (8):
- R25-11
rel:R25-11#9014bbf32026-09-30 - R19-11
rel:R19-11#878a9ae32026-10-14 - R20-11
rel:R20-11#c8f140db2026-10-14 - R21-11
rel:R21-11#35984aa22026-10-14 - R22-11
rel:R22-11#86df5bb02026-10-14 - R23-11
rel:R23-11#a507e2692026-10-14 - R24-11
rel:R24-11#5c96fd1e2026-10-14 - R25-11
rel:R25-11#54be3f242026-10-14 active
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-medium· 2026-10-13