SecureStorageManager

PutDataAsync

Sintaxis:

PutDataAsync(<Clave>, <Datos>, <MétodoProtecciónAcceso>, <MétodoVerificación>)

Parámetros:

Tipo: String.
Clave para guardar los datos.

Tipo: Arbitrario.
Datos a proteger dentro de la aplicación (nombres de usuario o contraseñas). Se utiliza la serialización interna.
Advertencia. El valor de este parámetro no puede ser del tipo Undefined.

Tipo: SecureStorageAccessProtectionMethod.
Método de protección de acceso utilizado.

Tipo: AdditionalUserVerificationMethod.
Método de autenticación de usuario utilizado.
Es aplicable si se utiliza el método de protección de acceso AdditionalUserVerificationRequired. De lo contrario, se ignora.
Valor predeterminado: BiometricsOrPassword.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa es de tipo Boolean. Muestra que la autenticación del usuario fue cancelada por el usuario.

Descripción:

Función asíncrona. Guarda datos serializables en un almacenamiento seguro mediante una clave. El acceso al almacenamiento se proporciona según el parámetro de acceso pasado. Si ya existe un elemento con el valor de clave pasado, se reemplazan los datos de esta clave.
Si el tamaño de la clave y los datos serializados supera la longitud máxima de un registro, se produce la siguiente excepción: “El tamaño de los datos pasados para guardar supera la longitud máxima”. Límites de tamaño de registro:

• Android: no
• iOS: 16 MB
• Windows Phone: 16 KB

Si no hay suficiente memoria de almacenamiento al colocar los datos, se produce la siguiente excepción: “La memoria del almacenamiento seguro está llena. No se pueden guardar los datos”. Límites de tamaño de almacenamiento:

• Android: no
• iOS: 80 MB
• Windows Phone: 320 KB

Si se alcanza el límite de número de registros al colocar los datos en el almacenamiento, se produce la siguiente excepción: “Se ha alcanzado el límite máximo de número de registros en el almacenamiento seguro. No se pueden guardar los datos”. Límites de número de registros:

• Android: no
• iOS: no
• Windows Phone: 20.

La llamada al método no bloquea la ejecución del código. Todos los resultados se devuelven al controlador de notificaciones pasado. La colocación de datos se lleva a cabo según el método de protección de acceso pasado (puede ser necesaria la autenticación del usuario o el desbloqueo de la pantalla).
Si <MétodoProtecciónAcceso> se establece en AdditionalUserVerificationRequired, se requerirá una autenticación del usuario mediante la entrada de una contraseña o el uso de una huella digital en Windows Runtime. La operación de autenticación del usuario puede ser cancelada por el usuario.

Disponibilidad:

Cliente móvil, aplicación móvil (cliente).

Consulte también:

SecureStorageManager, método BeginPutData

Disponible desde:

Disponible desde la versión 8.3.18.