ICertPropertyBackedUp::Initialize-Methode (certenroll.h)
Die Initialize-Methode initialisiert das Objekt aus einem booleschen Wert und einem Datum.
Syntax
HRESULT Initialize(
[in] VARIANT_BOOL BackedUpValue,
[in] DATE Date
);
Parameter
[in] BackedUpValue
Eine VARIANT_BOOL Variable, die angibt, ob das Zertifikat gesichert wurde.
[in] Date
Eine DATE-Variable , die angibt, wann ein Zertifikat zuletzt gesichert wurde.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Das Objekt ist bereits initialisiert. |
|
Die angegebene Zeit ist ungültig. |
Hinweise
Das Datum wird als 8-Byte-Realwert gespeichert, der ein Datum zwischen dem 1. Januar 1900 und dem 31. Dezember 9999 einschließlich darstellt. Der Wert 2,0 steht für den 1. Januar 1900; 3.0 steht für den 2. Januar 1900. Durch Hinzufügen von 1 zum Wert wird das Datum um einen Tag erhöht. Der Bruchteil des Werts stellt die Tageszeit dar. Daher steht 2.5 für 12:00 Uhr am 1. Januar 1900; 3.25 steht für 06:00 Uhr am 2. Januar 1900.
Für Datumsangaben zwischen 1950 und einschließlich 2049 werden Datum und Uhrzeit UTC-Zeit im Format YYYMMDDHHMMSS codiert. Für Datumsangaben vor 1950 oder nach 2049 wird die codierte generalisierte Zeit verwendet. Die codierte generalisierte Zeit hat die Form YYYYMMDDHHMMSSMMM mit einem vierstelligen Jahr und ist auf Millisekunden genau.
Rufen Sie die SetValueOnCertificate-Methode auf, um die Eigenschaft einem Zertifikat zuzuordnen. Rufen Sie die BackedUpTime-Eigenschaft auf, um das Datum abzurufen. Rufen Sie die BackedUpValue-Eigenschaft auf, um den booleschen Wert abzurufen, der angibt, ob ein Zertifikat gesichert wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certenroll.h |
| DLL | CertEnroll.dll |