SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadataAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスで実装されている場合は、 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
非同期操作を取り消すトークン。
返品
完了すると、列マスター キー メタデータのシグネチャを表す Byte 配列が返されるタスク。 署名形式はプロバイダー固有です。
注釈
既定の実装では、最初に cancellationToken がチェックされ、取り消しが要求された場合は取り消されたタスクが返されます。 それ以外の場合は、同期 SignColumnMasterKeyMetadata(String, Boolean) メソッドが呼び出され、既定で NotImplementedException がスローされます。 この場合、返されたタスクは同期的にスローされるのではなく、 NotImplementedException でエラーが発生します。
I/O を実行する派生クラスは、キャンセル トークンを受け入れる真の非同期実装でこのメソッドをオーバーライドする必要があります。
Always Encrypted でエンクレーブを使用するキー ストア プロバイダーは、署名操作に I/O が含まれる場合に、このメソッドを真に非同期の実装でオーバーライドする必要があります。