SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Saat diimplementasikan dalam kelas turunan, secara asinkron menandatangani metadata kunci master kolom dengan kunci master kolom yang direferensikan masterKeyPath oleh parameter .
public virtual System.Threading.Tasks.Task<byte[]> SignColumnMasterKeyMetadataAsync(string masterKeyPath, bool allowEnclaveComputations, System.Threading.CancellationToken cancellationToken = default);abstract member SignColumnMasterKeyMetadataAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>
override this.SignColumnMasterKeyMetadataAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<byte[]>Public Overridable Function SignColumnMasterKeyMetadataAsync (masterKeyPath As String, allowEnclaveComputations As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Byte())Parameter
- masterKeyPath
- String
Jalur kunci master kolom. Format jalur khusus untuk implementasi penyedia penyimpanan kunci (misalnya thumbprint untuk penyimpanan sertifikat, atau URL pengidentifikasi kunci untuk Azure Key Vault).
- allowEnclaveComputations
- Boolean
true untuk menunjukkan bahwa kunci master kolom mendukung komputasi enklave; jika tidak, false. Ketika true, tanda tangan yang dihasilkan mencakup properti yang diaktifkan enklave sehingga metadata nantinya dapat diverifikasi untuk penggunaan enklave.
- cancellationToken
- CancellationToken
Token untuk membatalkan operasi asinkron.
Mengembalikan
Tugas yang, setelah selesai, mengembalikan array yang Byte mewakili tanda tangan metadata kunci master kolom. Format tanda tangan khusus penyedia.
Keterangan
Implementasi default pertama-tama cancellationToken memeriksa dan mengembalikan tugas yang dibatalkan jika pembatalan telah diminta. Jika tidak, metode ini memanggil metode sinkron SignColumnMasterKeyMetadata(String, Boolean) , yang melempar NotImplementedException secara default. Dalam hal ini, tugas yang dikembalikan akan disalahkan daripada NotImplementedException dilemparkan secara sinkron.
Kelas turunan yang melakukan I/O harus mengambil alih metode ini dengan implementasi yang benar-benar asinkron yang menghormati token pembatalan.
Penyedia penyimpanan kunci yang ingin menggunakan enklave dengan Always Encrypted harus mengambil alih metode ini dengan implementasi yang benar-benar asinkron ketika operasi penandatanganan melibatkan I/O.