本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
NCryptSignHash 使用金鑰儲存提供者 (KSP)
NCryptSignHash 函數會建立雜湊值的簽章。
參數
-
hKey【in】 -
用來簽署雜湊的金鑰控點。
pPaddingInfo【in，選用】-
包含填補資訊的結構指標。結構類型取決於
dwFlags值。僅將此參數與非對稱索引鍵搭配使用；NULL將其他索引鍵類型設為 。 pbHashValue【in】-
緩衝區的指標，其中包含要簽署的雜湊值。使用 指定緩衝區大小
cbHashValue。 cbHashValue【in】-
要簽署之
pbHashValue緩衝區的大小，以位元組為單位。 pbSignature【輸出】-
儲存簽章的緩衝區地址。使用 指定緩衝區大小
cbSignature。若要判斷所需的緩衝區大小，請將此參數設定為 NULL。函數會將所需的大小 （以位元組為單位） 存放在 指向的位置
pcbResult。 cbSignature【in】-
pbSignature緩衝區的大小，以位元組為單位。如果pbSignature是 ，則函數會忽略此參數NULL。 pcbResult【輸出】-
DWORD 變數的指標，可存放複製到
pbSignature緩衝區的位元組數。如果
pbSignature是 NULL，則會以位元組為單位存放所需的緩衝區大小。 dwFlags【in】-
用於修改函數行為的旗標。允許的旗標取決於您的金鑰類型。使用下列其中一個值：
Value 意義 BCRYPT_PAD_PKCS1
使用PKCS1填充方案。
pPaddingInfo設定為指向BCRYPT_PKCS1_PADDING_INFO結構。BCRYPT_PAD_PSS
使用概率簽章結構描述 (PSS) 填補結構。設定
pPaddingInfo參數以指向BCRYPT_PSS_PADDING_INFO結構。NCRYPT_SILENT_FLAG
此旗標沒有效果。
傳回值
函數會傳回狀態碼，表示成功或失敗。
常見的傳回碼包括：
| 傳回代碼 | 描述 |
|---|---|
|
ERROR_SUCCESS |
操作已成功完成。 |
|
NTE_INVALID_PARAMETER |
一或多個參數無效。 |
|
NTE_FAIL |
操作無法完成。 |
|
NTE_INVALID_HANDLE |
中的控點 |
|
NTE_BAD_FLAGS |
|
|
NTE_BUFFER_TOO_SMALL |
|
|
NTE_BAD_KEY_STATE |
金鑰狀態無效。 |
|
NTE_INTERNAL_ERROR |
簽署雜湊時發生內部錯誤。 |
