CryptGetMessageCertificates 函式 (wincrypt.h)

  • 發行項

CryptGetMessageCertificates 函式會傳回包含訊息憑證和 CRL 之開啟證書存儲的句柄。 此函式會使用提供者類型CERT_STORE_PROV_PKCS7作為其 lpszStoreProvider 參數來呼叫 CertOpenStore。

語法

HCERTSTORE CryptGetMessageCertificates(
  [in] DWORD             dwMsgAndCertEncodingType,
  [in] HCRYPTPROV_LEGACY hCryptProv,
  [in] DWORD             dwFlags,
  [in] const BYTE        *pbSignedBlob,
  [in] DWORD             cbSignedBlob
);

參數

[in] dwMsgAndCertEncodingType

指定使用的編碼類型。 將憑證和 訊息編碼類型 與位 OR 作業結合在一起，一律可以接受，如下列範例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

目前定義的編碼類型如下：

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] hCryptProv

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

Windows Server 2003 和 Windows XP： 傳遞至 CertOpenStore 的 CSP 句柄。 如需詳細資訊，請參閱 CertOpenStore。除非有在 hCryptProv 中傳遞特定密碼編譯提供者的強原因，否則傳遞零會導致取得預設 RSA 或 DSS 提供者。

此參數的數據類型為 HCRYPTPROV。

[in] dwFlags

傳遞至 CertOpenStore 的旗標。 如需詳細資訊，請參閱 CertOpenStore。

[in] pbSignedBlob

包含已簽署訊息之緩衝 CRYPT_INTEGER_BLOB 結構的指標。

[in] cbSignedBlob

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

傳回值

傳回包含訊息憑證和CRL的 證書存儲 。 發生錯誤時，會傳回 NULL 。

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

傳回碼 Description
E_INVALIDARG
 無效的訊息和憑證編碼類型。 目前僅支援PKCS_7_ASN_ENCODING和X509_ASN_ENCODING。
 

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

備註

使用 GetLastError 來判斷任何錯誤的原因。

範例

如需使用此函式的範例，請參閱 範例 C 程式：設定和取得證書儲存屬性。

規格需求

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

另請參閱

CryptVerifyMessageSignature

簡化的訊息函式