SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Se implementato in una classe derivata, firma in modo asincrono i metadati della chiave master della colonna con la chiave master della colonna a cui fa riferimento il masterKeyPath parametro .
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())
Parametri
- masterKeyPath
- String
Percorso della chiave master della colonna. Il formato del percorso è specifico per l'implementazione del provider dell'archivio chiavi, ad esempio un'identificazione personale per l'archivio certificati o un URL dell'identificatore di chiave per Azure Key Vault.
- allowEnclaveComputations
- Boolean
true per indicare che la chiave master della colonna supporta i calcoli dell'enclave; in caso contrario, false. Quando true, la firma generata copre la proprietà abilitata per l'enclave in modo che i metadati possano essere verificati in un secondo momento per l'uso dell'enclave.
- cancellationToken
- CancellationToken
Token per annullare l'operazione asincrona.
Valori restituiti
Attività che, al termine, restituisce una Byte matrice che rappresenta la firma dei metadati della chiave master della colonna. Il formato della firma è specifico del provider.
Commenti
L'implementazione predefinita controlla innanzitutto e restituisce un'attività cancellationToken annullata se è stato richiesto l'annullamento. In caso contrario, chiama il metodo sincrono SignColumnMasterKeyMetadata(String, Boolean) , che genera un'eccezione NotImplementedException per impostazione predefinita. In questo caso, l'attività restituita verrà restituita con NotImplementedException errori anziché generare in modo sincrono.
Le classi derivate che eseguono operazioni di I/O devono eseguire l'override di questo metodo con un'implementazione veramente asincrona che rispetta il token di annullamento.
I provider dell'archivio chiavi che desiderano usare enclave con Always Encrypted devono eseguire l'override di questo metodo con un'implementazione veramente asincrona quando l'operazione di firma comporta operazioni di I/O.