CTL_FIND_USAGE_PARA 结构 (wincrypt.h)

  • 项目

CTL_FIND_USAGE_PARA 结构是 CTL_FIND_SUBJECT_PARA 结构的成员，由 CertFindCTLInStore 使用。

语法

typedef struct _CTL_FIND_USAGE_PARA {
  DWORD           cbSize;
  CTL_USAGE       SubjectUsage;
  CRYPT_DATA_BLOB ListIdentifier;
  PCERT_INFO      pSigner;
} CTL_FIND_USAGE_PARA, *PCTL_FIND_USAGE_PARA;

成员

cbSize

此结构的大小（以字节为单位）。

SubjectUsage

CTL_USAGE 结构，其中包含在查找证书 信任列表 (CTL) 时要匹配的对象标识符序列。

找到的 CTL 必须包含 由 SubjectUsage 成员指定的所有使用对象标识符。

如果此结构的 cUsageIdentifier 成员为零，则具有任何用法的 CTL 可以是匹配项。

ListIdentifier

指定以将搜索限制为特定的签名者 CTL 列表。 通常 ，ListIdentifier 成员将为零，表示可以匹配任何 ListIdentifier 。 如果它不为零，则此 ListIdentifier 和 CTL 中的 ListIdentifier 必须匹配。

若要仅匹配没有 ListIdentifier 的 CTL，ListIdentifier 的 cbData 成员设置为CTL_FIND_NO_LIST_ID_CBDATA。

CTL 使用 ListIdentifier 来区分由具有相同 SubjectUsage 的同一颁发者创建的多个 CTL。

pSigner

指向 CERT_INFO 结构的指针，该结构指定要匹配的 CTL 签名者。 仅使用 CERT_INFO 中的颁发者和序列号来匹配签名者。

将 pSigner 设置为 NULL 以匹配任何签名者。 若要匹配没有任何签名者的 CTL，请将 pSigner 设置为 CTL_FIND_NO_SIGNER_PTR。

签名者的 CertEncodingType 是从 CertFindCTLInStore 的 dwMsgAndCertEncodingType 参数获取的。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 wincrypt.h

另请参阅

CERT_INFO

CRYPT_INTEGER_BLOB

CTL_FIND_SUBJECT_PARA

CTL_USAGE

CertFindCTLInStore