SecureStorageManager

BeginPutData

Sintaxis:

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

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: MobileClientSignatureVerificationMethod.
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.

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará después de que se coloquen los datos con los siguientes parámetros:

• <CanceladoPorUsuario> – el tipo Boolean.
• <Clave> – el tipo String. Clave pasada.
• <ParámetrosAdicionales> – un valor especificado al crear el objeto CallbackDescription.

Si se produce un error durante la ejecución del procedimiento, se llama al controlador de errores.

Descripción:

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 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 lanza 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 lanza la siguiente excepción: “La memoria de 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 lanza 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 desbloqueo de pantalla).
Si <MétodoProtecciónAcceso> tiene el valor AdditionalUserVerificationRequired, se requerirá una autenticación de usuario mediante la entrada de una contraseña o el uso de una huella digital en Windows Runtime. La operación de autenticación de usuario puede ser cancelada por el usuario.

Disponibilidad:

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

Consulte también:

SecureStorageManager, método PutDataAsync

Disponible desde:

Disponible desde la versión 8.3.15.

Descripción cambiada en la versión 8.3.18.