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 |