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

  • [アーティクル]

Initialize メソッドは、ブール値と日付からオブジェクトを初期化します。

構文

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)
 指定された時刻が無効です。

注釈

日付は、1900 年 1 月 1 日から 9999 年 12 月 31 日までの日付を表す 8 バイトの実値として格納されます。 値 2.0 は 1900 年 1 月 1 日を表します。3.0 は 1900 年 1 月 2 日を表します。 値に 1 を追加すると、日付が 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