CryptMsgVerifyCountersignatureEncoded 函式 (wincrypt.h)

  • 發行項

CryptMsgVerifyCountersignatureEncoded 函式會根據 PKCS #7) 所定義的 SignerInfo 結構 (來驗證計數器簽署。

語法

BOOL CryptMsgVerifyCountersignatureEncoded(
  [in] HCRYPTPROV_LEGACY hCryptProv,
  [in] DWORD             dwEncodingType,
  [in] PBYTE             pbSignerInfo,
  [in] DWORD             cbSignerInfo,
  [in] PBYTE             pbSignerInfoCountersignature,
  [in] DWORD             cbSignerInfoCountersignature,
  [in] PCERT_INFO        pciCountersigner
);

參數

[in] hCryptProv

不使用此參數，而且應該設定為 NULL。

Windows Server 2003 和 Windows XP： NULL 或 密碼編譯提供者 的句柄，用來 哈希pbSignerInfo 的 encryptedDigest 字段。此參數的數據類型為 HCRYPTPROV。

除非有在 hCryptProv 中傳入特定密碼編譯提供者的強原因，否則傳遞 NULL 會導致使用預設 RSA 或 DSS 提供者。

[in] dwEncodingType

指定使用的編碼類型。 目前只會使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;不過，未來可能會新增其他編碼類型。 針對目前的編碼類型，請使用：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING。

[in] pbSignerInfo

編碼 BLOB 的指標，其中包含要計數器簽署之訊息內容的簽署者。

[in] cbSignerInfo

內容的簽署者之編碼 BLOB 的計數，以位元組為單位。

[in] pbSignerInfoCountersignature

包含計數器簽署資訊之編碼 BLOB 的指標。

[in] cbSignerInfoCountersignature

訊息的計數器簽署者的編碼 BLOB 計數，以位元組為單位。

[in] pciCountersigner

包含計數器簽署者的簽發者和序號 之CERT_INFO 指標。 如需詳細資訊，請參閱＜備註＞。

傳回值

如果函式成功，則傳回值為非零 (TRUE) 。

如果函式失敗，則傳回值為零， (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。

下表列出 GetLastError 函式最常傳回的錯誤碼。

傳回碼 Description
CRYPT_E_AUTH_ATTR_MISSING
 訊息不包含預期的已驗證屬性。
CRYPT_E_HASH_VALUE
 哈希值不正確。
CRYPT_E_UNEXPECTED_ENCODING
 訊息未如預期編碼。
CRYPT_E_UNKNOWN_ALGO
 密碼編譯演算法未知。
E_INVALIDARG
 一或多個自變數無效。
E_OUTOFMEMORY
 記憶體不足。
 

可能會傳回來自下列函式的傳播錯誤。

如果函式失敗， GetLastError 可能會傳回 抽象語法表示法一 (ASN.1) 編碼/譯碼錯誤。 如需這些錯誤的相關信息，請參閱 ASN.1 編碼/譯碼傳回值。

備註

計數器簽署器驗證是使用 PKCS #7 SIGNERINFO 結構來完成。 簽章必須包含 pbSignerInfo 之 encryptedDigest 欄位的加密哈希。

countersigner 的簽發者和序號必須符合 pbSignerInfoCountersignature 的 countersigner 資訊。 pciCountersigner 參考的唯一字段是 SerialNumber、Issuer 和 SubjectPublicKeyInfo。 SubjectPublicKeyInfo 可用來存取公鑰，然後用來加密 pciCountersigner 的哈希，以便與 pbSignerInfo 中的哈希進行比較。

範例

如需使用此函式的範例，請參閱 範例 C 程式：編碼和譯碼計數器簽署訊息。

規格需求

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

另請參閱

CryptMsgCountersign

CryptMsgCountersignEncoded

低階訊息函式

簡化的訊息函式