ICertPropertyBackedUp：：InitializeFromCurrentTime 方法 (certenroll.h)

  • 项目

InitializeFromCurrentTime 方法从布尔值和当前系统日期和时间初始化 属性。

语法

HRESULT InitializeFromCurrentTime(
  [in] VARIANT_BOOL BackedUpValue
);

参数

[in] BackedUpValue

一个 VARIANT_BOOL 变量，用于标识是否已备份证书。

返回值

如果函数成功，该函数将返回 S_OK。

如果函数失败，它将返回一个 指示错误的 HRESULT 值。 可能的值包括（但并不限于）下表中的项。 有关常见错误代码的列表，请参阅 通用 HRESULT 值。

返回代码/值 说明
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
对象已初始化。
HRESULT_FROM_WIN32 (ERROR_INVALID_DATA)
指定的时间无效。

注解

在内部，InitializeFromCurrentTime 调用 Windows SDK中的 GetSystemTimeAsFileTime 函数。 日期存储为 8 字节实际值，表示 1900 年 1 月 1 日到 9999 年 12 月 31 日（含）之间的日期。 值 2.0 表示 1900 年 1 月 1 日;3.0 表示 1900 年 1 月 2 日。 向 值添加 1 会将日期递增一天。 值的分数部分表示一天中的时间。 因此，2.5 表示 1900 年 1 月 1 日 12：00;3.25 表示 1900 年 1 月 2 日 6：00。

对于 1950 年至 2049 年（含）的日期，日期和时间编码为 UTC 时间，格式为 YYMMDDHHMMSS。 对于 1950 年之前或 2049 年之后的日期，使用编码的通用时间。 编码的通用时间采用 YYYYYMMDDHHMMSSMMM 的形式，使用四位数年份，精确到毫秒。

调用 SetValueOnCertificate 方法将 属性与证书相关联。 若要检索日期，请调用 BackedUpTime 属性。 若要检索标识证书是否已备份的布尔值，请调用 BackedUpValue 属性。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

ICertProperty

ICertPropertyBackedUp