SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.1.0

Asynchronně dešifruje zašifrovanou hodnotu šifrovacího klíče sloupce. Očekává se, že šifrovaná hodnota bude zašifrována pomocí hlavního klíče sloupce se zadanou cestou klíče a pomocí zadaného algoritmu.

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())

Parametry

masterKeyPath

String

Cesta k hlavnímu klíči sloupce. Formát cesty je specifický pro implementaci zprostředkovatele úložiště klíčů (např. kryptografický otisk úložiště certifikátů nebo adresu URL identifikátoru klíče pro Azure Key Vault).

encryptionAlgorithm

String

Název šifrovacího algoritmu. Například: RSA_OAEP.

encryptedColumnEncryptionKey

Byte[]

Šifrovací klíč šifrovaného sloupce.

cancellationToken

CancellationToken

Token pro zrušení asynchronní operace.

Návraty

Task<Byte[]>

Úloha, která vrací Byte pole představující šifrovací klíč dešifrovaného sloupce po dokončení.

Poznámky

Výchozí implementace nejprve zkontroluje cancellationToken a vrátí zrušený úkol, pokud bylo požadováno zrušení. V opačném případě volá synchronní DecryptColumnEncryptionKey(String, String, Byte[]) metodu a zabalí výsledek do dokončené úlohy. Pokud synchronní metoda vyvolá výjimku, je zachycena a chybný úkol se vrátí místo synchronně vyvolání.

Odvozené třídy, které provádějí vstupně-výstupní operace (například volání Azure Key Vault), by měly tuto metodu přepsat skutečně asynchronní implementací, která respektuje token zrušení.