BCryptDuplicateKey

対称キーの複製を作成する。

BCryptDuplicateKey hKey, phNewKey, pbKeyObject, cbKeyObject, dwFlags

hKey : [int] 複製するキーのハンドル。これは対称キーへのハンドルでなければならない。
phNewKey : [var] 複製キーのハンドルを受け取る BCRYPT_KEY_HANDLE 変数へのポインタ。このハンドルは BCryptEncrypt のようにキーを必要とする後続の関数で使用される。このハンドルが不要になったら、BCryptDestroyKey 関数に渡して解放しなければならない。
pbKeyObject : [var] 複製されたキーオブジェクトを受け取るバッファへのポインタ。cbKeyObject パラメータがこのバッファのサイズを示す。必要なバッファサイズは、BCryptGetProperty 関数を呼び出して BCRYPT_OBJECT_LENGTH プロパティを取得することで得られる。これは指定したアルゴリズムにおけるキーオブジェクトのサイズを返す。このメモリは phNewKey キーハンドルが破棄された後にのみ解放できる。
cbKeyObject : [int] pbKeyObject バッファのバイト単位のサイズ。
dwFlags : [int] 関数の動作を変更するフラグの集合。現在定義されているフラグはないため、このパラメータには 0 を指定する。

(プラグイン / モジュール : bcrypt.dll)

解説

対称キーの複製を作成する。

[戻り値]
関数の成否を示すステータスコードを返す。
返される可能性のあるコードには次のものが含まれるが、これらに限られない。
（以下省略）

[備考]
プロバイダがサポートするプロセッサモードに応じて、BCryptDuplicateKey
はユーザーモードまたはカーネルモードのいずれからでも呼び出せる。カーネルモードの呼び出し元は PASSIVE_LEVEL IRQL または
DISPATCH_LEVEL IRQL のいずれかで実行できる。現在の IRQL レベルが DISPATCH_LEVEL
である場合、hKey パラメータに渡すハンドルは BCRYPT_PROV_DISPATCH
フラグを指定してオープンされたプロバイダから返されたアルゴリズムハンドルから取得されたものでなければならず、BCryptDuplicateKey
関数に渡すポインタはページング不可（あるいはロックされた）メモリを参照しなければならない。この関数をカーネルモードで呼び出すには、Driver
Development Kit (DDK) に含まれる Cng.lib を使用する。Windows Server 2008 および
Windows Vista: この関数をカーネルモードで呼び出すには Ksecdd.lib を使用する。

情報