ICertPropertyBackedUp::Initialize 方法(certenroll.h)

Initialize 方法从布尔值和日期初始化对象。

Syntax

HRESULT Initialize(
  [in] VARIANT_BOOL BackedUpValue,
  [in] DATE         Date
);

参数

[in] BackedUpValue

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

[in] Date

一个 DATE 变量,用于标识上次备份证书的日期。

返回值

如果函数成功,该函数将返回 S_OK

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

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

注解

日期存储为 8 字节的实值,表示 1900 年 1 月 1 日至 9999 年 12 月 31 日之间的日期(包括 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 日 06:00。

对于包含 1950 到 2049 之间的日期,日期和时间采用 YYMMDDHHMMSS 格式编码 UTC 时间。 对于 1950 年或 2049 年之后的日期,使用编码的通用时间。 编码的通用时间采用 YYYYMMDDHHMMSSMMM,使用四位数年份,精确到毫秒。

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

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows操作系统
Header certenroll.h
DLL CertEnroll.dll

另请参阅

ICertProperty

ICertPropertyBackedUp