共用方式為

CryptVerifyMessageSignatureWithKey 函式 (wincrypt.h)

  • 發行項

CryptVerifyMessageSignatureWithKey 函式會使用指定的公鑰資訊來驗證已簽署訊息的簽章。

語法

BOOL CryptVerifyMessageSignatureWithKey(
  [in]      PCRYPT_KEY_VERIFY_MESSAGE_PARA pVerifyPara,
  [in]      PCERT_PUBLIC_KEY_INFO          pPublicKeyInfo,
  [in]      const BYTE                     *pbSignedBlob,
  [in]      DWORD                          cbSignedBlob,
  [out]     BYTE                           *pbDecoded,
  [in, out] DWORD                          *pcbDecoded
);

參數

[in] pVerifyPara

包含驗證參數 之CRYPT_KEY_VERIFY_MESSAGE_PARA 結構的指標。

[in] pPublicKeyInfo

CERT_PUBLIC_KEY_INFO 結構的指標，其中包含用來驗證已簽署訊息的公鑰。 如果 為 NULL，則不會驗證簽章。

[in] pbSignedBlob

緩衝區的指標，其中包含已簽署的訊息。

[in] cbSignedBlob

已簽署訊息緩衝區的大小，以位元組為單位。

[out] pbDecoded

要接收譯碼訊息之緩衝區的指標。

如果額外的處理不需要譯碼的訊息，或為記憶體配置設定訊息的大小，這個參數可以是 NULL 。 如需詳細資訊，請參閱 擷取未知長度的數據。

[in, out] pcbDecoded

DWORD 值的指標，指定 pbDecoded 緩衝區的大小，以位元組為單位。 當函式傳回時，這個 DWORD 會包含譯碼訊息的大小，以位元組為單位。 如果此參數為 NULL，將不會傳回譯碼的訊息。

注意 處理傳回的數據時，應用程式必須使用傳回之數據的實際大小。 實際大小可能比輸入上指定的緩衝區大小稍微小一點。 (輸入時，通常會指定足夠的緩衝區大小，以確保最大可能的輸出數據會符合 buffer.) On 輸出中，此參數所指向的變數會更新，以反映複製到緩衝區的數據的實際大小。
 

傳回值

如果函式成功，函式會傳回非零。

如果函式失敗，它會傳回零。 如需擴充錯誤資訊，請呼叫 GetLastError。

下表顯示 GetLastError 函式最常傳回的錯誤碼。

傳回碼 Description
ERROR_MORE_DATA
 如果 pbDecoded 參數指定的緩衝區不夠大，無法保存傳回的數據，則函式會設定ERROR_MORE_DATA程式代碼，並以位元組為單位，將所需的緩衝區大小以位元組為單位儲存在 由coded 所指向的變數中。
E_INVALIDARG
 無效的訊息和憑證編碼類型。 目前僅支援PKCS_7_ASN_ENCODING和X509_ASN_ENCODING_TYPE。 *pVerifyPara 中的 cbSize 無效。
CRYPT_E_UNEXPECTED_MSG_TYPE
 不是已簽署的密碼編譯訊息。
CRYPT_E_NO_SIGNER
 訊息沒有任何簽署者或指定 dwSignerIndex 的簽署者。
NTE_BAD_ALGID
 訊息已哈希，並使用未知或不支援的演算法進行簽署。
NTE_BAD_SIGNATURE
 訊息的簽章未驗證。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll