BCryptDuplicateHash

既存のハッシュまたはメッセージ認証コード (MAC) オブジェクトを複製する。

BCryptDuplicateHash hHash, phNewHash, pbHashObject, cbHashObject, dwFlags

hHash : [int] 複製するハッシュまたは MAC オブジェクトのハンドル。
phNewHash : [var] 複製されたハッシュまたは MAC オブジェクトを表すハンドルを受け取る BCRYPT_HASH_HANDLE 値へのポインタ。
pbHashObject : [var] 複製されたハッシュまたは MAC オブジェクトを受け取るバッファへのポインタ。cbHashObject パラメータがこのバッファのサイズを示す。必要なバッファサイズは、BCryptGetProperty 関数を呼び出して BCRYPT_OBJECT_LENGTH プロパティを取得することで得られる。これは指定したアルゴリズムにおけるハッシュオブジェクトのサイズを返す。複製ハッシュハンドルが解放された後、このメモリを解放する。
cbHashObject : [int] pbHashObject バッファのバイト単位のサイズ。
dwFlags : [int] 関数の動作を変更するフラグの集合。現在定義されているフラグはないため、このパラメータには 0 を指定する。

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

解説

既存のハッシュまたはメッセージ認証コード (MAC) オブジェクトを複製する。

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

[備考]
この関数は、共通データブロックに対するハッシュまたは MAC を計算する際に役立つ。共通データを処理した後、ハッシュまたは MAC
オブジェクトを複製し、その後個々のオブジェクトに固有のデータを追加できる。プロバイダがサポートするプロセッサモードに応じて、BCryptDuplicateHash
はユーザーモードまたはカーネルモードのいずれからでも呼び出せる。カーネルモードの呼び出し元は PASSIVE_LEVEL IRQL または
DISPATCH_LEVEL IRQL のいずれかで実行できる。現在の IRQL レベルが DISPATCH_LEVEL
である場合、hHash パラメータに渡すハンドルは BCRYPT_PROV_DISPATCH
フラグを指定してオープンされたプロバイダから返されたアルゴリズムハンドルから取得されたものでなければならず、BCryptDestroyKey
関数に渡すポインタはページング不可（あるいはロックされた）メモリを参照しなければならない。この関数をカーネルモードで呼び出すには、Driver
Development Kit (DDK) に含まれる Cng.lib を使用する。Windows Server 2008 および
Windows Vista: この関数をカーネルモードで呼び出すには Ksecdd.lib を使用する。

情報