CryptDuplicateHash

複製が行われた時点までのハッシュの正確なコピーを作成する。

CryptDuplicateHash hHash, pdwReserved, dwFlags, phHash

hHash : [int] 複製するハッシュのハンドル。
pdwReserved : [var] 将来の使用のために予約されており、ゼロでなければならない。
dwFlags : [int] 将来の使用のために予約されており、ゼロでなければならない。
phHash : [var] 複製されたハッシュのハンドルのアドレス。ハッシュの使用が終わったら、CryptDestroyHash 関数を呼び出してハンドルを解放する。

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

解説

複製が行われた時点までのハッシュの正確なコピーを作成する。

[戻り値]
関数が成功した場合は TRUE を返す。失敗した場合は FALSE を返す。拡張エラー情報を取得するには GetLastError
を呼び出す。「NTE」で始まるエラーコードは使用中の特定の暗号化サービスプロバイダ (CSP)
が生成する。以下のエラーコードが返される可能性がある。
（以下省略）

[備考]
CryptDuplicateHash はハッシュとその正確な状態のコピーを作成する。この関数は、呼び出し元のアプリケーションで 2
つのハッシュを生成する必要があり、どちらのハッシュも共通のデータをハッシュ化した状態から開始する必要がある場合に使用されうる。たとえば、ハッシュを作成して共通データをハッシュ化し、CryptDuplicateHash
関数で複製を作成してから、各ハッシュに固有のデータを追加する。CryptDuplicateHash
で作成されたハッシュを破棄するには、CryptDestroyHash
関数を呼び出さなければならない。元のハッシュを破棄しても、複製されたハッシュは破棄されない。複製ハッシュが作成された後は、元のハッシュとは独立している。2
つのハッシュの間に共有状態は存在しない。

情報