ICertPropertyBackedUp::InitializeFromCurrentTime メソッド (certenroll.h)
InitializeFromCurrentTime メソッドは、ブール値と現在のシステムの日付と時刻から プロパティを初期化します。
構文
HRESULT InitializeFromCurrentTime(
[in] VARIANT_BOOL BackedUpValue
);
パラメーター
[in] BackedUpValue
証明書 が バックアップされているかどうかを識別するVARIANT_BOOL変数。
戻り値
関数が成功した場合、関数は S_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。
| リターン コード/値 | Description |
|---|---|
|
オブジェクトは既に初期化されています。 |
|
指定した時刻が無効です。 |
注釈
内部的には、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 日の 06:00 を表します。
1950 年から 2049 年までの日付の場合、日付と時刻は YYMMDDHHMMSS 形式で UTC 時刻でエンコードされます。 1950 年より前または 2049 年より前の日付では、エンコードされた一般化された時刻が使用されます。 エンコードされた一般化された時間は、4 桁の年を使用する YYYYMMDDHHMMSSMMM の形式であり、精度はミリ秒です。
SetValueOnCertificate メソッドを呼び出して、 プロパティを証明書に関連付けます。 日付を取得するには、 BackedUpTime プロパティを呼び出します。 証明書がバックアップされたかどうかを識別するブール値を取得するには、 BackedUpValue プロパティを呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | certenroll.h |
| [DLL] | CertEnroll.dll |