SqlColumnEncryptionKeyStoreProvider.DecryptColumnEncryptionKeyAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie odszyfrowuje określoną zaszyfrowaną wartość klucza szyfrowania kolumny. Oczekuje się, że zaszyfrowana wartość będzie szyfrowana przy użyciu klucza głównego kolumny z określoną ścieżką klucza i przy użyciu określonego algorytmu.
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
Ścieżka klucza głównego kolumny. Format ścieżki jest specyficzny dla implementacji dostawcy magazynu kluczy (np. odcisk palca magazynu certyfikatów lub adres URL identyfikatora klucza dla Azure Key Vault).
- encryptionAlgorithm
- String
Nazwa algorytmu szyfrowania. Na przykład RSA_OAEP.
- encryptedColumnEncryptionKey
- Byte[]
Zaszyfrowany klucz szyfrowania kolumny.
- cancellationToken
- CancellationToken
Token umożliwiający anulowanie operacji asynchronicznej.
Zwraca
Zadanie zwracające tablicę reprezentującą Byte odszyfrowany klucz szyfrowania kolumny po zakończeniu.
Uwagi
Domyślna implementacja najpierw sprawdza cancellationToken i zwraca anulowane zadanie, jeśli zażądano anulowania. W przeciwnym razie wywołuje metodę synchroniczną DecryptColumnEncryptionKey(String, String, Byte[]) i opakowuje wynik w ukończonym zadaniu. Jeśli metoda synchroniczna zgłasza błąd, wyjątek zostanie przechwycony i zostanie zwrócone uszkodzone zadanie zamiast zgłaszać synchronicznie.
Klasy pochodne wykonujące operacje we/wy (takie jak wywołania Azure Key Vault) powinny zastąpić tę metodę prawdziwie asynchroniczną implementacją, która honoruje token anulowania.