SqlColumnEncryptionKeyStoreProvider.EncryptColumnEncryptionKeyAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Criptografa de forma assíncrona uma chave de criptografia de coluna usando a chave mestra de coluna com o caminho de chave especificado e usando o 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
O caminho da chave mestra da coluna. O formato de caminho é específico para a implementação do provedor do repositório de chaves (por exemplo, uma impressão digital para o repositório de certificados ou uma URL do identificador de chave para Azure Key Vault).
- encryptionAlgorithm
- String
O nome do algoritmo de criptografia. Por exemplo, RSA_OAEP.
- columnEncryptionKey
- Byte[]
A chave de criptografia de coluna a ser criptografada.
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Retornos
Uma tarefa que retorna uma Byte matriz que representa a chave de criptografia de coluna criptografada após a conclusão.
Comentários
A implementação padrão primeiro verifica e cancellationToken retorna uma tarefa cancelada se o cancelamento foi solicitado. Caso contrário, ele chama o método síncrono EncryptColumnEncryptionKey(String, String, Byte[]) e encapsula o resultado em uma tarefa concluída. Se o método síncrono for gerado, a exceção será capturada e uma tarefa com falha será retornada em vez de ser lançada de forma síncrona.
Classes derivadas que executam E/S (como chamadas para Azure Key Vault) devem substituir esse método por uma implementação verdadeiramente assíncrona que honre o token de cancelamento.