clase ara::per::FileStorage

El método síncrono DeleteFile de la clase ara::per::FileStorage elimina un archivo del almacenamiento de archivos [SWS_PER_00111] en función de su nombre (fileName). El identificador puede corresponder al PersistencyFile.fileName configurado [SWS_PER_00111]. La llamada está especificada como noexcept, se considera segura frente a excepciones y segura para hilos, y notifica el resultado mediante ara::core::Result<void> [SWS_PER_00111].

Antes de la llamada, deben haber finalizado todos los accesos activos al archivo de destino. Si el archivo está abierto en ese momento, la operación de eliminación falla con el error PerErrc::kResourceBusy [SWS_PER_00111]. Por lo tanto, las aplicaciones deben asegurarse de que las instancias de UniqueHandle creadas previamente mediante OpenFileReadWrite [SWS_PER_00113], OpenFileReadOnly [SWS_PER_00114] o OpenFileWriteOnly [SWS_PER_00115] hayan salido de su ámbito de validez, cerrando así el archivo. Asimismo, una ejecución paralela de RecoverFile [SWS_PER_00337] o ResetFile [SWS_PER_00338] para el mismo nombre de archivo conduce a PerErrc::kResourceBusy [SWS_PER_00111].

En caso de error, el tipo Result devuelto proporciona causas de error específicas [SWS_PER_00111]:

• PerErrc::kFileNotFound: El archivo especificado no existe en el almacenamiento de archivos [SWS_PER_00111].
• PerErrc::kIllegalWriteAccess: El File Storage está configurado como de solo lectura [SWS_PER_00111].
• PerErrc::kPhysicalStorageFailure: Falla el acceso al medio de almacenamiento físico (sin semántica de reversión) [SWS_PER_00111].
• PerErrc::kIntegrityCorrupted, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed: Errores en la integridad estructural, en el cifrado/descifrado o en la verificación MAC (en cada caso con semántica de reversión), así como errores específicos del fabricante [SWS_PER_00111].

El método síncrono FileExists de la clase ara::per::FileStorage comprueba si un archivo existe en el almacenamiento de archivos correspondiente [SWS_PER_00112]. La función está declarada como noexcept y no lanza excepciones de C++ [SWS_PER_00112].

usar

Como parámetro se pasa fileName como ara::core::StringView, lo que puede corresponder al identificador PersistencyFile.fileName de un archivo configurado [SWS_PER_00112]. El valor de retorno ara::core::Result<bool> devuelve true si el archivo pudo localizarse y, en caso contrario, false [SWS_PER_00112].

Manejo de errores

Si la comprobación falla, el Result devuelto no contiene un valor booleano, sino un código de error [SWS_PER_00112]. Las causas de error especificadas son:

• PerErrc::kPhysicalStorageFailure al fallar el acceso al almacenamiento físico [SWS_PER_00112],
• PerErrc::kIntegrityCorrupted en caso de integridad estructural dañada de los datos [SWS_PER_00112],
• PerErrc::kValidationFailed cuando no se puede garantizar la validez de los datos almacenados [SWS_PER_00112],
• PerErrc::kEncryptionFailed en caso de fallo en el descifrado [SWS_PER_00112],
• PerErrc::kAuthenticationFailed al fallar la comprobación del MAC [SWS_PER_00112], así como posibles errores específicos del fabricante [SWS_PER_00112].

Concurrencia y restricciones

El método está declarado como seguro para subprocesos [SWS_PER_00112]. No obstante, el resultado de comprobación entregado solo es exacto mientras no se añadan ni eliminen archivos en el almacenamiento simultáneamente; por ejemplo, si otro subproceso elimina un archivo directamente tras la devolución de true, el resultado ya no es válido [SWS_PER_00112].

El método OpenFileReadOnly de la clase ara::per::FileStorage (declarado en #include "ara/per/file_storage.h") abre un archivo persistido como de solo lectura con un modo de acceso especificado [SWS_PER_00114]. A menos que se especifique lo contrario mediante el parámetro mode, la posición del puntero de lectura se establece por defecto al inicio del archivo (kAtTheBeginning) [SWS_PER_00114]. La ejecución se realiza de forma síncrona y devuelve un ara::core::Result<UniqueHandle<ReadAccessor>>. El manipulador utiliza semántica RAII: en cuanto la instancia de UniqueHandle abandona su ámbito de validez, el archivo se cierra automáticamente [SWS_PER_00114].

En cuanto a la concurrencia, el método está especificado como thread-safe y exception safe (con noexcept) [SWS_PER_00114]. No obstante, existen restricciones de invocación funcionales: si el archivo de destino ya está abierto o se ejecutan al mismo tiempo operaciones como DeleteFile, RecoverFile o ResetFile con el mismo nombre de archivo, la invocación falla con PerErrc::kResourceBusy [SWS_PER_00114].

En caso de error, el ara::core::Result devuelve errores específicos del fabricante o códigos de error estandarizados de PerErrc o bien StorageFailure [SWS_PER_00114]:

• PerErrc::kFileNotFound: El archivo especificado no existe en el almacenamiento de archivos [SWS_PER_00114].
• PerErrc::kInvalidOpenMode: El modo transferido contiene una combinación no válida de indicadores (flags) [SWS_PER_00114].
• StorageFailure: El acceso al almacenamiento físico ha fallado [SWS_PER_00114].
• PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kAuthenticationFailed o PerErrc::kEncryptionFailed: Integridad estructural dañada, validación insuficiente, comprobación MAC defectuosa o descifrado fallido [SWS_PER_00114].

En interacción con otras interfaces, FileStorage ofrece dos sobrecargas relacionadas: una variante sin parámetro de modo, que abre siempre al inicio del archivo [SWS_PER_00376], así como una sobrecarga con búfer (ara::core::Span<ara::core::Byte> buffer), a través de la cual el ReadAccessor implementa lectura por bloques para acelerar múltiples accesos pequeños [SWS_PER_00430].

usar

El método OpenFileReadOnly de la clase ara::per::FileStorage abre un archivo persistido en modo de solo lectura [SWS_PER_00376]. La llamada se realiza a través del archivo de cabecera ara/per/file_storage.h pasando el nombre de archivo fileName. En este proceso, la posición de lectura se establece inicialmente al principio del archivo. Como valor de retorno sirve un ara::core::Result, que en caso de éxito proporciona un UniqueHandle<ReadAccessor>. El archivo abierto se cierra automáticamente en cuanto este manejador sale de su ámbito de validez.

Manejo de errores

Si la ejecución falla, el resultado contiene un código de error o un error específico del fabricante [SWS_PER_00376]:

• PerErrc::kFileNotFound: El archivo especificado no existe en el almacenamiento.
• PerErrc::kResourceBusy: El archivo ya está abierto o se procesa simultáneamente mediante DeleteFile, RecoverFile o ResetFile.
• PerErrc::kPhysicalStorageFailure: El acceso al medio de almacenamiento físico ha fallado.
• PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: Errores en la integridad de la estructura, validación de datos, descifrado o comprobación MAC.

Concurrencia e interacción

El método está especificado como thread-safe, exception safe y noexcept [SWS_PER_00376]. Para requisitos avanzados, se encuentran disponibles sobrecargas: una variante para la especificación explícita de un OpenMode [SWS_PER_00114], así como una signatura con un búfer de usuario adicional para la aceleración por bloques de accesos de lectura más pequeños [SWS_PER_00430].

El método síncrono OpenFileReadOnly de la clase ara::per::FileStorage abre un archivo persistido para acceso de lectura utilizando un búfer proporcionado por la entidad emisora de la llamada [SWS_PER_00430]. El acceso al archivo se inicializa a partir de los parámetros fileName, mode y buffer (como ara::core::Span<ara::core::Byte>) [SWS_PER_00430]. A menos que se indique lo contrario mediante mode, la posición de lectura se encuentra por defecto al principio del archivo (kAtTheBeginning) [SWS_PER_00430]. La región de memoria pasada es utilizada por el ReadAccessor resultante para acelerar accesos de lectura pequeños repetidos mediante lectura por bloques [SWS_PER_00430]. El recurso está protegido mediante RAII: en cuanto el UniqueHandle devuelto sale del ámbito de validez, el archivo se cierra automáticamente [SWS_PER_00430].

En cuanto a la concurrencia, la función está especificada como segura para hilos (thread-safe), segura frente a excepciones (exception safe) y noexcept [SWS_PER_00430]. Si se produce un error, el ara::core::Result proporciona errores específicos del fabricante o códigos de error estandarizados procedentes de PerErrc [SWS_PER_00430]:

• PerErrc::kResourceBusy: El archivo ya está abierto o se procesa simultáneamente mediante DeleteFile, RecoverFile o ResetFile [SWS_PER_00430].
• PerErrc::kFileNotFound: El archivo especificado no existe en el almacenamiento de archivos [SWS_PER_00430].
• PerErrc::kInvalidOpenMode: El modo pasado contiene una combinación de opciones no válida [SWS_PER_00430].
• Errores de integridad y de seguridad: PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed (fallo de la comprobación MAC), así como StorageFailure en caso de errores de acceso a la memoria física [SWS_PER_00430].

Junto a esta variante con búfer, para casos de uso sin búfer definido por el usuario se encuentran disponibles las sobrecargas [SWS_PER_00114] (con mode) y [SWS_PER_00376] (solo con fileName).

usar

El método síncrono OpenFileReadWrite de la clase ara::per::FileStorage abre un archivo para accesos de lectura y escritura en el modo especificado mode [SWS_PER_00113]. A menos que se especifique lo contrario en el modo, el puntero del archivo se sitúa por defecto al principio (kAtTheBeginning). Si el archivo aún no existe, se crea automáticamente [SWS_PER_00113]. La función devuelve un ara::core::Result con un UniqueHandle<ReadWriteAccessor>, el cual cierra automáticamente el archivo en cuanto el handle sale de su ámbito de validez [SWS_PER_00113].

Concurrencia y restricciones

La llamada es segura para subprocesos (thread-safe) y no lanza excepciones (noexcept) [SWS_PER_00113]. El archivo no debe estar ya abierto en el momento de la llamada. Además, no debe tener lugar ninguna ejecución simultánea de DeleteFile, RecoverFile o ResetFile con el mismo nombre de archivo, ya que de lo contrario la llamada fallará con PerErrc::kResourceBusy [SWS_PER_00113].

Manejo de errores

En caso de error, el ara::core::Result contiene códigos de error específicos [SWS_PER_00113]:

• PerErrc::kInvalidOpenMode: Combinación no válida de flags en el mode pasado.
• PerErrc::kResourceBusy: El archivo de destino ya está abierto o está ocupado por operaciones administrativas de archivos.
• Access: El almacenamiento está configurado como read-only o como write-only-once en caso de una clave ya existente.
• PerErrc::kOutOfStorageSpace o PerErrc::kTooManyFiles: Espacio de almacenamiento físico insuficiente o superación de maxNumberOfFiles al crearlo de nuevo.
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed, PerErrc::kAuthenticationFailed: Errores de acceso al hardware, estructuras de datos corruptas o validaciones criptográficas fallidas.

Interacción

Como variante simplificada, está disponible una sobrecarga sin parámetro de modo, la cual abre los archivos por defecto al principio [SWS_PER_00375]. Para la optimización del rendimiento en caso de numerosos accesos pequeños, existe además una sobrecarga con búfer definido por el usuario (buffer) para lectura y escritura por bloques [SWS_PER_00429].

La función miembro síncrona OpenFileReadWrite de la clase ara::per::FileStorage sirve para abrir un archivo para accesos combinados de lectura y escritura [SWS_PER_00375]. Como parámetro se pasa el nombre de archivo fileName como ara::core::StringView, el cual puede corresponder al modelado PersistencyFile.fileName de un archivo configurado [SWS_PER_00375]. Si el archivo especificado aún no existe, se crea automáticamente de nuevo [SWS_PER_00375]. Al abrirse, la posición del archivo se sitúa inmediatamente al principio (conforme a kAtTheBeginning) [SWS_PER_00375]. El llamador recibe un ara::core::Result<UniqueHandle<ReadWriteAccessor>>; el archivo se cierra automáticamente en cuanto el UniqueHandle devuelto sale de su ámbito de validez [SWS_PER_00375].

En cuanto a concurrencia y contexto de ejecución, la función está especificada como thread-safe y exception safe [SWS_PER_00375]. No obstante, debe tenerse en cuenta que los accesos simultáneos están reglamentados: si el archivo ya está abierto o si se ejecuta simultáneamente una operación como DeleteFile, RecoverFile o ResetFile sobre el mismo nombre de archivo, la llamada falla y devuelve el código de error PerErrc::kResourceBusy [SWS_PER_00375].

En caso de error, el objeto Result devuelto encapsula errores específicos de la persistencia o errores específicos del fabricante [SWS_PER_00375]:

• errores de configuración y de acceso como Access en caso de almacenamiento protegido contra escritura o de datos ya existentes con configuración Write-Once [SWS_PER_00375].
• límites de espacio de almacenamiento debidos a PerErrc::kOutOfStorageSpace o PerErrc::kTooManyFiles en caso de superación del límite superior configurado para el archivo [SWS_PER_00375].
• errores de integridad y de seguridad tales como PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed [SWS_PER_00375].

En combinación con otras interfaces de FileStorage, AUTOSAR ofrece sobrecargas alternativas: OpenFileReadWrite puede invocarse con OpenMode explícito [SWS_PER_00113] o con un área de memoria adicional por parte del usuario buffer (ara::core::Span<ara::core::Byte>), que permite una amortiguación por bloques para acelerar accesos pequeños y repetidos [SWS_PER_00429].

usar

El método OpenFileReadWrite de la clase ara::per::FileStorage abre un archivo de forma síncrona para lectura y escritura combinadas proporcionando un búfer definido por el usuario [SWS_PER_00429]. La región de memoria pasada buffer (como ara::core::Span<ara::core::Byte>) es utilizada internamente por el ReadWriteAccessor para operaciones de lectura y escritura por bloques, con el fin de procesar series de accesos pequeños con alto rendimiento. Si el archivo especificado aún no existe, se crea de nuevo automáticamente; la posición del archivo se encuentra por defecto al principio (kAtTheBeginning), siempre que no se indique lo contrario en el mode pasado [SWS_PER_00429]. El archivo se cierra en cuanto el UniqueHandle devuelto en el ara::core::Result sale de su ámbito de validez. Interpretación: presumiblemente, la memoria subyacente del span de búfer pasado debe permanecer válida durante toda la vida útil del UniqueHandle, ya que el descriptor de acceso la referencia para accesos por bloques. Pregunta Q-e0009b7de17e3597 (abierta)

Tratamiento de errores y concurrencia

La función está especificada como noexcept, segura frente a excepciones (exception safe) y segura para hilos [SWS_PER_00429]. En caso de fallos, el Result proporciona errores específicos del fabricante o códigos de error definidos:

• PerErrc::kResourceBusy: El archivo ya está abierto o se procesa simultáneamente mediante DeleteFile, RecoverFile o ResetFile con el mismo nombre [SWS_PER_00429].
• Access: La región de memoria está configurada como read-only o definida como write-only-once y ya ocupada [SWS_PER_00429].
• PerErrc::kInvalidOpenMode: El mode pasado contiene una combinación de características no válida [SWS_PER_00429].
• PerErrc::kOutOfStorageSpace o PerErrc::kTooManyFiles: La memoria física no es suficiente para una nueva creación o se superaría el límite configurado maxNumberOfFiles [SWS_PER_00429].
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed y PerErrc::kAuthenticationFailed: Errores durante el acceso, durante la comprobación de integridad, MAC o validación, así como durante el descifrado [SWS_PER_00429].

Interacción

El método representa una variante optimizada en rendimiento de la apertura de lectura/escritura: mientras que [SWS_PER_00113] solo procesa el nombre de archivo y el modo y [SWS_PER_00375] exclusivamente el nombre de archivo, [SWS_PER_00429] permite la aceleración específica de accesos de E/S pequeños mediante un búfer de memoria explícito.

usar

El método OpenFileWriteOnly de la clase ara::per::FileStorage abre un archivo de forma síncrona para escritura exclusiva con un modo de acceso definido [SWS_PER_00115]. A menos que se indique lo contrario a través del parámetro mode, el archivo se trunca durante el proceso (conforme a kTruncate). Si el archivo aún no existe, se crea de nuevo. Como valor devuelto se utiliza un ara::core::Result<UniqueHandle<WriteAccessor>>; al salir del ámbito de validez del UniqueHandle, el archivo se vuelve a cerrar automáticamente [SWS_PER_00115].

Manejo de errores

En caso de error, el Result devuelto contiene códigos de error específicos [SWS_PER_00115]: Access indica que el almacenamiento es de solo lectura o que se ha configurado como Write-Once y la clave ya existe. PerErrc::kInvalidOpenMode notifica combinaciones de modo no válidas y PerErrc::kOutOfStorageSpace, espacio de almacenamiento físico insuficiente. Además, pueden producirse PerErrc::kTooManyFiles, PerErrc::kPhysicalStorageFailure, así como errores de integridad y de seguridad tales como PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed [SWS_PER_00115].

Concurrencia y restricciones

La función está concebida como segura frente a hilos y segura frente a excepciones (noexcept) [SWS_PER_00115]. Los accesos paralelos al mismo archivo fallan con el código de error PerErrc::kResourceBusy si el archivo ya está abierto o si se ejecutan simultáneamente operaciones como DeleteFile, RecoverFile o ResetFile con el mismo nombre de archivo [SWS_PER_00115].

Interacción

Junto a esta función, la interfaz proporciona una sobrecarga simplificada sin parámetro de modo que opera por defecto con kTruncate [SWS_PER_00377], así como una sobrecarga con búfer definido por el usuario para permitir la escritura por bloques a fin de acelerar numerosos accesos pequeños [SWS_PER_00431].

usar

El método síncrono OpenFileWriteOnly de la clase ara::per::FileStorage abre un archivo exclusivamente para escritura según [SWS_PER_00377]. Toma a través del parámetro fileName el nombre del archivo de destino. En caso de que el archivo no exista, se crea de nuevo; un archivo ya existente se trunca (conforme a kTruncate) [SWS_PER_00377]. Como valor de retorno sirve un ara::core::Result, que en caso de éxito encapsula un ara::per::UniqueHandle<WriteAccessor>. Este manejador cierra el archivo automáticamente según el patrón RAII en cuanto sale del ámbito de validez [SWS_PER_00377].

Tratamiento de errores y concurrencia

La operación está declarada como noexcept, es segura frente a excepciones y segura para hilos [SWS_PER_00377]. En caso de error, el Result contiene un código de error específico de PerErrc o un error específico del fabricante [SWS_PER_00377]:

• PerErrc::kResourceBusy: El archivo ya está abierto o se está procesando simultáneamente mediante DeleteFile, RecoverFile o ResetFile.
• PerErrc::kOutOfStorageSpace y PerErrc::kTooManyFiles: La memoria física no es suficiente o se supera el número máximo de archivos configurados (maxNumberOfFiles).
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed: Errores en el acceso al hardware, así como en las comprobaciones de integridad, validación o descifrado.

Interacción

Mientras que esta variante predetermina de forma fija el truncamiento, la sobrecarga con el parámetro OpenMode permite un modo de apertura divergente [SWS_PER_00115]. Para operaciones de escritura optimizadas por bloques con múltiples accesos pequeños, se encuentra a disposición otra sobrecarga con búfer definido por el usuario (ara::core::Span<ara::core::Byte>) [SWS_PER_00431].

El método síncrono OpenFileWriteOnly de la clase ara::per::FileStorage abre un archivo exclusivamente para escritura y, en caso de éxito, devuelve un ara::core::Result<UniqueHandle<WriteAccessor>> [SWS_PER_00431]. Al salir del ámbito de validez del UniqueHandle devuelto, el archivo abierto se cierra automáticamente [SWS_PER_00431]. La llamada toma, además del nombre de archivo fileName y del modo de acceso mode, un búfer por parte del usuario buffer (como ara::core::Span<ara::core::Byte>) que se utiliza para escritura por bloques a fin de acelerar accesos de escritura pequeños repetidos [SWS_PER_00431]. Si no se configura de forma divergente en el modo, el archivo se trunca al abrirse (conforme a kTruncate); si aún no existe, se crea de nuevo [SWS_PER_00431].

En cuanto a concurrencia y seguridad, el método está especificado como thread-safe y exception safe, y declarado como noexcept [SWS_PER_00431]. Sin embargo, el acceso falla si el archivo ya está abierto o si se ejecutan simultáneamente operaciones de administración como DeleteFile, RecoverFile o ResetFile sobre el mismo nombre de archivo [SWS_PER_00431].

En caso de error, se devuelve en el resultado el código de error correspondiente procedente de PerErrc o un error específico del fabricante [SWS_PER_00431]:

• PerErrc::kResourceBusy: El archivo ya está abierto o está ocupado por otra operación de archivo [SWS_PER_00431].
• PerErrc::kIllegalWriteAccess: El File Storage está protegido contra escritura o configurado como write-only-once y el archivo ya existe [SWS_PER_00431].
• PerErrc::kInvalidOpenMode: La combinación de modos transferida no es válida [SWS_PER_00431].
• PerErrc::kOutOfStorageSpace o PerErrc::kTooManyFiles: El espacio de almacenamiento es insuficiente o se supera el número máximo de archivos configurados [SWS_PER_00431].
• PerErrc::kPhysicalStorageFailure, PerErrc::kIntegrityCorrupted, PerErrc::kValidationFailed, PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed: Error en el acceso físico, la integridad, la validación, el descifrado o la autenticación [SWS_PER_00431].

En interacción con otras interfaces, la función amplía de forma específica los métodos básicos [SWS_PER_00377] (solo fileName) y [SWS_PER_00115] (con mode) con soporte de búfer para operaciones de escritura optimizadas [SWS_PER_00431].

usar

El método síncrono RecoverFile de la clase ara::per::FileStorage lleva a cabo una restauración de mejor esfuerzo (best effort) de un archivo individual cuando fallan las comprobaciones de redundancia [SWS_PER_00337]. El identificador del archivo afectado se pasa mediante el parámetro fileName como ara::core::StringView. Tras la restauración, el archivo puede presentar estados obsoletos o el contenido inicial, o bien, en el peor de los casos, haberse perdido [SWS_PER_00337].

Concurrencia e interacción

La operación está especificada como segura para hilos y segura frente a excepciones [SWS_PER_00337]. No obstante, no debe ejecutarse sobre archivos abiertos: antes de la llamada, deben estar cerradas todas las instancias de UniqueHandle obtenidas previamente mediante métodos de apertura de archivos como [SWS_PER_00113], [SWS_PER_00114] o [SWS_PER_00375] [SWS_PER_00337]. De lo contrario, la llamada falla con PerErrc::kResourceBusy. Se notifica el mismo error si se ejecuta simultáneamente [SWS_PER_00111] (DeleteFile) o [SWS_PER_00338] (ResetFile) para el mismo nombre de archivo [SWS_PER_00337].

Manejo de errores

La función devuelve un ara::core::Result<void> [SWS_PER_00337]. Además de PerErrc::kResourceBusy, pueden producirse los siguientes errores estandarizados:

• PerErrc::kFileNotFound: El archivo especificado no existe en el almacenamiento de archivos [SWS_PER_00337].
• PerErrc::kPhysicalStorageFailure: Falla el acceso al medio de almacenamiento físico [SWS_PER_00337].
• PerErrc::kOutOfStorageSpace: El espacio de almacenamiento físico disponible no es suficiente para el archivo restaurado [SWS_PER_00337].
• PerErrc::kQuotaExceeded: El archivo restaurado superaría el límite configurado maximumAllowedSize [SWS_PER_00337].
• PerErrc::kEncryptionFailed y PerErrc::kAuthenticationFailed: Ha fallado el descifrado criptográfico o la validación MAC de los datos almacenados [SWS_PER_00337].

El método síncrono ResetFile de la clase ara::per::FileStorage restablece un archivo individual a su estado inicial preconfigurado [SWS_PER_00338]. Si el archivo especificado a través de fileName aún no existe en el almacenamiento, se crea de nuevo [SWS_PER_00338]. En ambos casos, el archivo pasa a tener el mismo contenido que tras una nueva instalación a partir de la Target Configuration actual [SWS_PER_00338]; su estado de modificación se gestiona en FileModificationState como kModifiedDuringReset [SWS_PER_00436].

La operación es segura para hilos y segura frente a excepciones, y devuelve de forma síncrona un ara::core::Result<void> [SWS_PER_00338]. Falla con PerErrc::kResourceBusy si el archivo está abierto en ese momento —por ejemplo a través de [SWS_PER_00113]— o si se produce simultáneamente una ejecución de [SWS_PER_00111] o [SWS_PER_00337] con el mismo nombre de archivo [SWS_PER_00338].

Asimismo, la interfaz define casos de error específicos [SWS_PER_00338]:

• PerErrc::kInitValueNotAvailable: No se ha configurado ningún valor inicial ni en el Application Design ni en la Target Configuration [SWS_PER_00338].
• PerErrc::kQuotaExceeded o PerErrc::kTooManyFiles: El archivo restaurado superaría el límite AllowedSize o maxNumberOfFiles [SWS_PER_00338].
• PerErrc::kOutOfStorageSpace o StorageFailure: El espacio de almacenamiento físico no es suficiente o el acceso físico falla [SWS_PER_00338].
• PerErrc::kEncryptionFailed o PerErrc::kAuthenticationFailed: Falla el cifrado o descifrado, o la comprobación MAC de los datos almacenados [SWS_PER_00338].