共用方式為

CERT_SELECT_CRITERIA結構 (wincrypt.h)

  • 發行項

CERT_SELECT_CRITERIA 結構會指定傳遞至 CertSelectCertificateChains 函式的選取準則。

語法

typedef struct _CERT_SELECT_CRITERIA {
  DWORD dwType;
  DWORD cPara;
  void  **ppPara;
} CERT_SELECT_CRITERIA, *PCERT_SELECT_CRITERIA;

成員

dwType

指定用於 ppPara 成員的選取準則類型。 這個成員可以有下列其中一個值。

值 意義
CERT_SELECT_BY_ENHKEY_USAGE
1
 根據特定的 增強金鑰使用方式選取憑證。 設定此旗標時， ppPara 必須參考 null 終止 的對象識別碼 ， (OID) ANSI 字串，以指定增強的密鑰使用方式。

此準則會在 憑證上進行評估。
CERT_SELECT_BY_KEY_USAGE
2
 根據憑證中的特定szOID_KEY_USAGE延伸模組 選取 憑證。 設定此旗標時， ppPara 成員必須參考 CERT_EXTENSION 結構，其中延伸模組的值是識別密鑰使用方式位的 DWORD 。

此準則會在憑證上進行評估。
CERT_SELECT_BY_POLICY_OID
3
 根據特定發行原則選取憑證。 ppPara 成員必須參考所需發行原則的 Null 終止 OID ANSI 字串。

此準則會在憑證鏈結的發行原則上進行評估。
CERT_SELECT_BY_PROV_NAME
4
 根據特定的 私鑰 提供者選取憑證。 ppPara 成員必須參考 Null 終止的 Unicode 字串，此字串代表提供者的名稱。
CERT_SELECT_BY_EXTENSION
5
 根據指定的延伸模組和選擇性指定的值來選取憑證。 ppPara 成員必須參考CERT_EXTENSION結構，以指定延伸 OID 和相關聯的值。
CERT_SELECT_BY_SUBJECT_HOST_NAME
6
 根據 [主體 DNS 主機名] 選取憑證。 ppPara 成員必須參考以 Null 結尾的 Unicode 字串，其中包含主體主機名。 根據這個旗標執行的選取專案，與呼叫 CertVerifyCertificateChainPolicy 函式期間，SSL_EXTRA_CERT_CHAIN_POLICY_PARA結構的 pwszServerName 成員評估相同。

此準則會在憑證上進行評估。
CERT_SELECT_BY_ISSUER_ATTR
7
 根據憑證簽發者的 相對辨別名稱 (RDN) 元素來選取憑證。 ppPara 成員必須參考包含簽發者 RDN 元素的CERT_RDN結構。

此準則會在憑證鏈結上進行評估。
CERT_SELECT_BY_SUBJECT_ATTR
8
 根據憑證主體中的 RDN 元素選取憑證。 ppPara 成員必須是包含 Subject 之 RDN 元素之CERT_RDN結構的參考。

此準則會在憑證上進行評估。
CERT_SELECT_BY_ISSUER_NAME
9
 根據憑證的簽發者選取憑證。 ppPara 成員必須是包含簽發者名稱之CERT_NAME_BLOB結構的參考。

此準則會在憑證鏈結上進行評估。
CERT_SELECT_BY_PUBLIC_KEY
10
 根據憑證的 公鑰 選取憑證。 ppPara 成員必須參考包含公鑰之CERT_PUBLIC_KEY_INFO結構的指標。

此準則會在憑證上進行評估。
CERT_SELECT_BY_TLS_SIGNATURES
11
 根據 傳輸層安全性通訊協定 (TLS) 簽章需求選取憑證。 ppPara 成員必須參考SecPkgContext_SupportedSignatures結構。

此準則會在憑證上進行評估。

cPara

DWORD 值，指定 ppPara 成員中指定的搜尋屬性數目。

ppPara

指向一或多個選取值的指標。 數據類型取決於 dwType 成員所指定的選取類型。 如果有多個選取值存在，應用程式必須只符合一個值。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 wincrypt.h