BCryptVerifySignature

指定された署名が指定されたハッシュと一致することを検証する。 (BCryptVerifySignature)

BCryptVerifySignature hKey, pPaddingInfo, pbHash, cbHash, pbSignature, cbSignature, dwFlags

hKey : [int] 署名を復号するために使用するキーのハンドル。これは BCryptSignHash 関数でデータに署名するために使用したキー、または、その鍵ペアの公開鍵部分でなければならない。
pPaddingInfo : [intptr] パディング情報を格納する構造体へのポインタ。このパラメータが指す構造体の実際の型は dwFlags パラメータの値に依存する。このパラメータは非対称キーでのみ使用され、それ以外の場合は NULL でなければならない。
pbHash : [var] データのハッシュを格納するバッファのアドレス。cbHash パラメータがこのバッファのサイズを示す。
cbHash : [int] pbHash バッファのバイト単位のサイズ。
pbSignature : [var] データの署名済みハッシュを格納するバッファのアドレス。署名は BCryptSignHash 関数を使用して作成する。cbSignature パラメータがこのバッファのサイズを示す。
cbSignature : [int] pbSignature バッファのバイト単位のサイズ。署名は BCryptSignHash 関数を使用して作成する。
dwFlags : [int] 関数の動作を変更するフラグの集合。指定可能なフラグは hKey パラメータで指定するキーの種類に依存する。キーが対称キーの場合、このパラメータは使用されないので 0 を指定する。

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

解説

指定された署名が指定されたハッシュと一致することを検証する。 (BCryptVerifySignature)

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

[備考]

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

情報