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