ICertPropertyBackedUp::InitializeFromCurrentTime メソッド (certenroll.h)

  • [アーティクル]

InitializeFromCurrentTime メソッドは、ブール値と現在のシステムの日付と時刻から プロパティを初期化します。

構文

HRESULT InitializeFromCurrentTime(
  [in] VARIANT_BOOL BackedUpValue
);

パラメーター

[in] BackedUpValue

証明書 が バックアップされているかどうかを識別するVARIANT_BOOL変数。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

リターン コード/値 Description
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 日の 06:00 を表します。

1950 年から 2049 年までの日付の場合、日付と時刻は YYMMDDHHMMSS 形式で UTC 時刻でエンコードされます。 1950 年より前または 2049 年より前の日付では、エンコードされた一般化された時刻が使用されます。 エンコードされた一般化された時間は、4 桁の年を使用する YYYYMMDDHHMMSSMMM の形式であり、精度はミリ秒です。

SetValueOnCertificate メソッドを呼び出して、 プロパティを証明書に関連付けます。 日付を取得するには、 BackedUpTime プロパティを呼び出します。 証明書がバックアップされたかどうかを識別するブール値を取得するには、 BackedUpValue プロパティを呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー certenroll.h
[DLL] CertEnroll.dll

こちらもご覧ください

ICertProperty

ICertPropertyBackedUp