CertIsRDNAttrsInCertificateName 函式 (wincrypt.h)

  • 發行項

CertIsRDNAttrsInCertificateName函式會比較憑證名稱中的屬性與指定的CERT_RDN，以判斷是否包含所有屬性。 比較會逐 一查看CERT_RDN ，並在憑證名稱的任何 CERT_RDN中尋找屬性相符專案。

語法

BOOL CertIsRDNAttrsInCertificateName(
  [in] DWORD           dwCertEncodingType,
  [in] DWORD           dwFlags,
  [in] PCERT_NAME_BLOB pCertName,
  [in] PCERT_RDN       pRDN
);

參數

[in] dwCertEncodingType

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

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

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

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] dwFlags

如果 pRDN 是以 Unicode 字串初始化，如同在 CryptEncodeObject 中將 lpszStructType 設定為 X509_UNICODE_NAME，則必須設定CERT_UNICODE_IS_RDN_ATTRS_FLAG。

CERT_CASE_INSENSITIVE_IS_RDN_ATTRS_FLAG設定為不區分大小寫的比對。 否則，會完成完全區分大小寫的比對。

[in] pCertName

包含編碼主體或簽發者名稱 之CRYPT_INTEGER_BLOB 指標。

[in] pRDN

包含名稱中要找到之屬性 的CERT_RDN 結構陣列。 CERT_RDN結構的CERT_RDN_ATTR成員會根據下列規則運作。

  • 如果 pszObjId 為 Null，則會忽略 OID) (屬性 物件識別碼 。
  • 如果 dwValueType 是CERT_RDN_ANY_TYPE，則會忽略實值型別。
  • 如果Value的pbData成員為Null，則任何值都可以相符。

傳回值

如果函式成功，且指定 之CERT_RDN 中的所有 RDN 值都位於憑證名稱中，則傳回值為非零 (TRUE) 。

如果函式失敗，或指定的CERT_RDN中有 RDN 值不在憑證名稱中，則傳回值會是零 (FALSE) 。 如需擴充錯誤資訊，請呼叫 GetLastError。

下表列出一些可能的錯誤碼。

傳回碼 描述
CRYPT_E_NO_MATCH
 並非所有屬性都已找到並相符。
ERROR_FILE_NOT_FOUND
 不正確憑證編碼類型。 目前僅支援X509_ASN_ENCODING。
 

如果函式失敗， GetLastError 可能會傳回 抽象語法標記法一 (ASN.1) 編碼/解碼錯誤。 如需這些錯誤的相關資訊，請參閱 ASN.1 編碼/解碼傳回值。

備註

目前僅支援完全區分大小寫的比對。

規格需求

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

另請參閱

CertFindCertificateInStore

資料管理函式