Language

SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync メソッド

定義

派生クラスで実装されている場合は、 masterKeyPath パラメーターによって参照される列マスター キーを使用して、列マスター キーメタデータに非同期的に署名します。

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

パラメーター

masterKeyPath
String

列マスター キーのパス。 パス形式は、キー ストア プロバイダーの実装 (証明書ストアの拇印、Azure Key Vaultのキー識別子 URL など) に固有です。

allowEnclaveComputations
Boolean

true 列マスター キーがエンクレーブ計算をサポートしていることを示す場合。それ以外の場合は false。 trueすると、生成されたシグネチャはエンクレーブ対応プロパティを対象とするため、後でエンクレーブの使用についてメタデータを検証できます。

cancellationToken
CancellationToken

非同期操作を取り消すトークン。

返品

Task<Byte[]>

完了すると、列マスター キー メタデータのシグネチャを表す Byte 配列が返されるタスク。 署名形式はプロバイダー固有です。

注釈

既定の実装では、最初に cancellationToken がチェックされ、取り消しが要求された場合は取り消されたタスクが返されます。 それ以外の場合は、同期 SignColumnMasterKeyMetadata(String, Boolean) メソッドが呼び出され、既定で NotImplementedException がスローされます。 この場合、返されたタスクは同期的にスローされるのではなく、 NotImplementedException でエラーが発生します。

I/O を実行する派生クラスは、キャンセル トークンを受け入れる真の非同期実装でこのメソッドをオーバーライドする必要があります。

Always Encrypted でエンクレーブを使用するキー ストア プロバイダーは、署名操作に I/O が含まれる場合に、このメソッドを真に非同期の実装でオーバーライドする必要があります。

適用対象