CryptGetTimeValidObject 函数 (wincrypt.h)

CryptGetTimeValidObject 函数检索在给定上下文和时间内有效的 CRL、OCSP 响应或 CTL 对象。

语法

BOOL CryptGetTimeValidObject(
  [in]                LPCSTR                                  pszTimeValidOid,
  [in]                LPVOID                                  pvPara,
  [in]                PCCERT_CONTEXT                          pIssuer,
  [in, optional]      LPFILETIME                              pftValidFor,
  [in]                DWORD                                   dwFlags,
  [in]                DWORD                                   dwTimeout,
  [out, optional]     LPVOID                                  *ppvObject,
  [in, optional]      PCRYPT_CREDENTIALS                      pCredentials,
  [in, out, optional] PCRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO pExtraInfo
);

参数

[in] pszTimeValidOid

指向标识所请求 对象的 OID) (对象标识符的指针。 如果 pszTimeValidOid 参数的 HIWORD 为零，则 LOWORD 指定指定结构的类型的整数标识符。

此参数的取值可为下列值之一： 有关这些值如何影响 pvPara 参数的信息，请参阅“含义”列中的标题“For the pvPara parameter”。

[in] pvPara

由 pszTimeValidOid 的值确定的结构。 有关详细信息，请参阅 pszTimeValidOid 参数的说明。

[in] pIssuer

指向包含颁发者证书 的CERT_CONTEXT 的指针。

[in, optional] pftValidFor

指向当前系统时间的可选 FILETIME 结构版本的指针，或当前上下文中的新鲜时间。

[in] dwFlags

一个 值，该值确定各种检索因素，例如超时、源和有效性检查。

下表列出了 dwFlags 参数的可能值。

[in] dwTimeout

一个值，以毫秒为单位，指定何时终止未返回结果的 URL 检索尝试。

[out, optional] ppvObject

指向返回的 对象的地址的指针。 返回类型可以是 CryptRetrieveObjectByUrl 函数的 pszObjectOid 参数中显示的受支持的类型之一。

[in, optional] pCredentials

指向用于访问 URL 的可选CRYPT_CREDENTIALS 结构的指针。 当前支持的唯一凭据类型是用户名和密码凭据。

[in, out, optional] pExtraInfo

指向可选的 CRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO 结构的指针，该结构包含有关对象的缓存条目的额外信息。

返回值

如果函数成功，则函数返回 TRUE。

如果函数失败，则返回 FALSE。 有关扩展的错误信息，请调用 GetLastError。

下面是一些可能的错误代码。

注解

Cryptnet 动态链接库实现一个时间有效的对象 (TVO) 缓存，该缓存用于支持 CryptGetTimeValidObject 函数。 缓存由进程全局 TVO 代理使用，其中每个缓存条目都包含以下信息。

• 源标识符
• 上下文 OID
• 上下文
• 检索 URL
• 过期时间
• 脱机 URL 时间信息

要求