BCryptVerifySignature 函式 （bcrypt.h）

BCryptVerifySignature 函式會驗證指定的簽章是否符合指定的哈希。

語法

NTSTATUS BCryptVerifySignature(
  [in]           BCRYPT_KEY_HANDLE hKey,
  [in, optional] VOID              *pPaddingInfo,
  [in]           PUCHAR            pbHash,
  [in]           ULONG             cbHash,
  [in]           PUCHAR            pbSignature,
  [in]           ULONG             cbSignature,
  [in]           ULONG             dwFlags
);

參數

[in] hKey

用來解密簽章之金鑰的句柄。 這必須是用來使用 BCryptSignHash 函式簽署數據之密鑰組的相同金鑰或公鑰部分。

[in, optional] pPaddingInfo

包含填補資訊之結構的指標。 此參數所指向的實際結構類型取決於 dwFlags 參數的值。 此參數只能與非對稱金鑰搭配使用，否則必須為 NULL 。

pPaddingInfo 必須是 NULL LMS 和 XMSS，因為不需要其他資訊才能產生密鑰和輸入以外的簽章。

[in] pbHash

包含數據哈希的緩衝區位址。 cbHash 參數包含這個緩衝區的大小。

[in] cbHash

pbHash 緩衝區的大小，以位元組為單位。

[in] pbSignature

緩衝區的位址，其中包含數據的帶正負號哈希。 BCryptSignHash 函式可用來建立簽章。 cbSignature 參數包含這個緩衝區的大小。

[in] cbSignature

pbSignature 緩衝區的大小，以位元組為單位。 BCryptSignHash 函式可用來建立簽章。

[in] dwFlags

一組旗標，可修改此函式的行為。 允許的旗標集取決於 hKey 參數所指定的索引鍵類型。

LMS 和 XMSS 的 dwFlags 必須為零，因為不需要其他資訊才能產生索引鍵和輸入以外的簽章。

如果密鑰是對稱金鑰，則不會使用此參數，而且應該是零。

如果金鑰是非對稱金鑰，這可以是下列其中一個值：

返回值

傳回狀態代碼，指出函式的成功或失敗。

可能的回傳代碼包括但不限於下列代碼：

備註

此函式會計算具有所提供索引鍵的簽章，然後將導出的簽章值與指定的簽章值進行比較。

若要使用此函式，您必須使用用來建立已簽署哈希值的相同哈希演算法來哈希數據。 如果適用，您也必須指定建立簽章時所指定的相同填補配置。

對於 ML-DSA 和 SLH-DSA，pbHash 和 cbHash 不一定是哈希值，而且可以是任意長度輸入。

根據提供者所支持的處理器模式， BCryptVerifySignature 可以從使用者模式或核心模式呼叫。 核心模式呼叫端可以在 IRQLPASSIVE_LEVEL 或 DISPATCH_LEVEL IRQL 上執行。 如果目前的 IRQL 層級 DISPATCH_LEVEL， 則 hKey 參數中提供的句柄必須衍生自使用 BCRYPT_PROV_DISPATCH 旗標開啟的提供者所傳回的演算法句柄，而且傳遞至 BCryptVerifySignature 函式的任何指標都必須參考非分頁或鎖定的記憶體。

若要在核心模式中呼叫此函式，請使用 Cng.lib，這是驅動程式開發工具包 （DDK） 的一部分。 Windows Server 2008 和 Windows Vista： 若要在核心模式中呼叫此函式，請使用 Ksecdd.lib。

需求

另請參閱

BCryptSignHash