wincrypt.h) (CTL_VERIFY_USAGE_STATUS 结构

  • 项目

CTL_VERIFY_USAGE_STATUS 结构包含 CertVerifyCTLUsage 返回的证书信任列表 (CTL) 的相关信息。

语法

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

成员

cbSize

结构的大小（以字节为单位）。 调用 CertVerifyCTLUsage 的应用程序设置此参数。 如果 cbSize 不大于或等于结构的所需大小，则 CertVerifyCTLUsage 返回 FALSE，GetLastError 返回E_INVALIDARG。

dwError

调用 CertVerifyCTLUsage 返回的错误状态（如果有）。 有关可能的错误值的列表，请参阅 CertVerifyCTLUsage 中的返回值部分。

dwFlags

如果返回 CERT_VERIFY_UPDATED_CTL_FLAG ， 则 CertVerifyCTLUsage 使用新的、时间有效的 CTL 更新了时间不再有效的 CTL。

ppCtl

指向指向包含匹配主题的 CTL 上下文 的指针的指针。 调用应用程序可以将此指针设置为 NULL ，以指示不返回包含主题的 CTL。

如果 ppCtl 不为 NULL，则调用应用程序必须使用 CertFreeCTLContext 释放返回的上下文。

dwCtlEntryIndex

返回 CTL 数组中匹配使用者条目的数组位置。

ppSigner

指向指向 CTL 签名者的证书上下文的指针的指针。 调用应用程序可以将此指针设置为 NULL ，指示不返回 CTL 的签名者的证书。

如果 ppSigner 不为 NULL，则调用应用程序必须使用 CertFreeCTLContext 释放返回的上下文。

dwSignerIndex

实际使用的签名者的索引。 如果消息有多个签名者，则为必需。

注解

调用应用程序应将 成员 dwError、 dwFlags、 dwCtlEntryIndex 和 dwSignerIndex 初始化为零。

要求

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

另请参阅

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage