SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cifra de forma asincrónica una clave de cifrado de columna mediante la clave maestra de columna con la ruta de acceso de clave especificada y utilizando el algoritmo especificado.
public virtual System.Threading.Tasks.Task<byte[]> EncryptColumnEncryptionKeyAsync(string masterKeyPath, string encryptionAlgorithm, byte[] columnEncryptionKey, System.Threading.CancellationToken cancellationToken = default);abstract member EncryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
override this.EncryptColumnEncryptionKeyAsync : string * string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Overridable Function EncryptColumnEncryptionKeyAsync (masterKeyPath As String, encryptionAlgorithm As String, columnEncryptionKey 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.
- columnEncryptionKey
- Byte[]
Clave de cifrado de columna que se va a cifrar.
- cancellationToken
- CancellationToken
Token para cancelar la operación asincrónica.
Devoluciones
Tarea que devuelve una Byte matriz que representa la clave de cifrado de columna cifrada 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 EncryptColumnEncryptionKey(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.