SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v7.1.0

Descifra de forma asincrónica el valor cifrado especificado de una clave de cifrado de columna. Se espera que el valor cifrado se cifre mediante la clave maestra de columna con la ruta de acceso de clave especificada y mediante el algoritmo especificado.

public virtual System.Threading.Tasks.Task<byte[]> DecryptColumnEncryptionKeyAsync(string masterKeyPath, string encryptionAlgorithm, byte[] encryptedColumnEncryptionKey, System.Threading.CancellationToken cancellationToken = default);

abstract member DecryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
override this.DecryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>

Public Overridable Function DecryptColumnEncryptionKeyAsync (masterKeyPath As String, encryptionAlgorithm As String, encryptedColumnEncryptionKey As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())

Parámetros

masterKeyPath

String

Ruta de acceso de la clave maestra de columna. El formato de ruta de acceso es específico de la implementación del proveedor del almacén de claves (por ejemplo, una huella digital para el almacén de certificados o una dirección URL de identificador de clave para Azure Key Vault).

encryptionAlgorithm

String

Nombre del algoritmo de cifrado. Por ejemplo: RSA_OAEP.

encryptedColumnEncryptionKey

Byte[]

Clave de cifrado de columna cifrada.

cancellationToken

CancellationToken

Token para cancelar la operación asincrónica.

Devoluciones

Task<Byte[]>

Tarea que devuelve una Byte matriz que representa la clave de cifrado de columna descifrada al finalizar.

Comentarios

La implementación predeterminada comprueba primero y cancellationToken devuelve una tarea cancelada si se ha solicitado la cancelación. De lo contrario, llama al método sincrónico DecryptColumnEncryptionKey(String, String, Byte[]) y ajusta el resultado en una tarea completada. Si se produce el método sincrónico, se detecta la excepción y se devuelve una tarea con errores en lugar de iniciarse de forma sincrónica.

Las clases derivadas que realizan E/S (por ejemplo, llamadas a Azure Key Vault) deben invalidar este método con una implementación verdaderamente asincrónica que respeta el token de cancelación.