翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
キーストレージプロバイダー (KSP) を使用した NCryptVerifySignature
NCryptVerifySignature 関数は、署名が指定されたハッシュと一致するかどうかを確認します。
パラメータ
-
hKey[in] -
署名を復号するために使用するキーのハンドル。NCryptSignHash でデータの署名に使用されたキーペアのパブリックキー部分を使用する必要があります。
pPaddingInfo[in, optional]-
パディング情報を含む構造へのポインタ。構造タイプは
dwFlags値によって異なります。このパラメータは非対称キーでのみ使用し、その他のキータイプでは NULL に設定します。 pbHashValue[in]-
署名するハッシュ値を含むバッファへのポインタ。
cbHashValueを使用してバッファサイズを指定します。 cbHashValue[in]-
pbHashValueバッファのサイズ (バイト単位)。 pbSignature[out]-
データの署名付きハッシュを含むバッファのアドレス。この署名を作成するには NCryptSignHash を使用します。
cbSignatureを使用してバッファサイズを指定します。 cbSignature[in]-
pbSignatureバッファのサイズ (バイト単位)。この署名を作成するには NCryptSignHash を使用します。 dwFlags[in]-
関数の動作を変更するためのフラグ。許可されるフラグは、キータイプによって異なります。次の値のいずれかを使用してください。
値 意味 NCRYPT_PAD_PKCS1_FLAG
署名に PKCS1 パディング が使用されたことを示します。
BCRYPT_PKCS1_PADDING_INFO構造体を指すようにpPaddingInfoを設定します。NCRYPT_PAD_PSS_FLAG
署名に確率的署名方式 (PSS) パディングが使用されたことを示します。
BCRYPT_PSS_PADDING_INFO構造体を指すようにpPaddingInfoを設定します。NCRYPT_SILENT_FLAG
このフラグは効果がありません。
戻り値
この関数は、成功または失敗を示すステータスコードを返します。
一般的なリターンコードは次のとおりです。
| リターンコード | 説明 |
|---|---|
|
ERROR_SUCCESS |
オペレーションが正常に完了しました。 |
|
NTE_INVALID_PARAMETER |
1 つ以上のパラメータが無効です。 |
|
NTE_FAIL |
オペレーションを完了できませんでした。 |
|
NTE_INVALID_HANDLE |
|
|
NTE_BAD_FLAGS |
|
|
NTE_BAD_SIGNATURE |
署名は検証されませんでした。 |
|
NTE_BAD_KEY_STATE |
キーの状態が無効です。 |
|
NTE_INTERNAL_ERROR |
署名の検証中に内部エラーが発生しました。 |
