SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
En cas d’implémentation dans une classe dérivée, signe de façon asynchrone les métadonnées de clé principale de colonne avec la clé principale de colonne référencée par le masterKeyPath paramètre.
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())Paramètres
- masterKeyPath
- String
Chemin de la clé principale de colonne. Le format de chemin est spécifique à l’implémentation du fournisseur de magasin de clés (par exemple, une empreinte numérique pour le magasin de certificats ou une URL d’identificateur de clé pour Azure Key Vault).
- allowEnclaveComputations
- Boolean
true pour indiquer que la clé principale de colonne prend en charge les calculs d’enclave ; sinon, false. Lorsque true, la signature générée couvre la propriété prenant en charge les enclaves afin que les métadonnées puissent être vérifiées ultérieurement pour une utilisation d’enclave.
- cancellationToken
- CancellationToken
Jeton pour annuler l’opération asynchrone.
Retours
Tâche qui, une fois terminée, retourne un Byte tableau représentant la signature des métadonnées de clé principale de colonne. Le format de signature est spécifique au fournisseur.
Remarques
L’implémentation par défaut vérifie d’abord la cancellationToken tâche annulée et retourne une tâche annulée si l’annulation a été demandée. Sinon, il appelle la méthode synchrone SignColumnMasterKeyMetadata(String, Boolean) , qui lève un NotImplementedException par défaut. Dans ce cas, la tâche retournée est défaillante NotImplementedException au lieu de lever de façon synchrone.
Les classes dérivées qui effectuent des E/S doivent remplacer cette méthode par une implémentation véritablement asynchrone qui respecte le jeton d’annulation.
Les fournisseurs de magasin de clés qui souhaitent utiliser des enclaves avec Always Encrypted doivent remplacer cette méthode par une implémentation véritablement asynchrone lorsque l’opération de signature implique des E/S.