NCryptSignHash とキーストレージプロバイダー (KSP) - AWS CloudHSM
パラメータ戻り値

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

NCryptSignHash とキーストレージプロバイダー (KSP)

NCryptSignHash 関数はハッシュ値の署名を作成します。

パラメータ

hKey [入力〕

ハッシュの署名に使用するキーのハンドル。

pPaddingInfo [入力、オプション〕

パディング情報を含む構造へのポインタ。構造タイプはdwFlags値によって異なります。このパラメータは非対称キーでのみ使用してください。他のキータイプでは NULL に設定されます。

pbHashValue [入力〕

署名するハッシュ値を含むバッファへのポインタ。を使用してバッファサイズを指定しますcbHashValue。

cbHashValue [入力〕

署名するpbHashValueバッファのサイズをバイト単位で指定します。

pbSignature [出力〕

署名を保存するバッファのアドレス。を使用してバッファサイズを指定しますcbSignature。

必要なバッファサイズを決定するには、このパラメータを NULL に設定します。関数は、必要なサイズ (バイト単位) を が指す場所に保存しますpcbResult。

cbSignature [入力〕

バイト単位のpbSignatureバッファのサイズ。が NULL の場合、関数pbSignatureはこのパラメータを無視します。

pcbResult [出力〕

pbSignature バッファにコピーされたバイト数を保存する DWORD 変数へのポインタ。

pbSignature が NULL の場合、必要なバッファサイズがバイト単位で保存されます。

dwFlags [入力〕

関数の動作を変更するフラグ。許可されるフラグは、キータイプによって異なります。次のいずれかの値を使用します。

値 意味

BCRYPT_PAD_PKCS1

PKCS1 パディングスキームを使用します。BCRYPT_PKCS1_PADDING_INFO 構造を指すpPaddingInfoように を設定します。

BCRYPT_PAD_PSS

確率的署名スキーム (PSS) パディングスキームを使用します。BCRYPT_PSS_PADDING_INFO 構造を指すようにpPaddingInfoパラメータを設定します。

NCRYPT_="ENT_FLAG

このフラグは効果がありません。

戻り値

関数は、成功または失敗を示すステータスコードを返します。

一般的なリターンコードは次のとおりです。

リターンコード 説明

エラー成功

オペレーションは正常に完了しました。

NTE_INVALID_PARAMETER

1 つ以上のパラメータが無効です。

NTE_FAIL

オペレーションを完了できませんでした。

NTE_INVALID_HANDLE

のハンドルhKeyが無効です。

NTE_BAD_FLAGS

dwFlags パラメータに無効な値が含まれています。

NTE_BUFFER_TOO_SMALL

pcbOutput 戻り値にはパラメータが小さすぎます。

NTE_BAD_KEY_STATE

キーの状態が無効です。

NTE_INTERNAL_ERROR

ハッシュの署名時に内部エラーが発生しました。