ICertPropertyBackedUp ::InitializeFromCurrentTime, méthode (certenroll.h)
La méthode InitializeFromCurrentTime initialise la propriété à partir d’une valeur booléenne et de la date et de l’heure système actuelles.
Syntaxe
HRESULT InitializeFromCurrentTime(
[in] VARIANT_BOOL BackedUpValue
);
Paramètres
[in] BackedUpValue
Variable VARIANT_BOOL qui identifie si le certificat a été sauvegardé.
Valeur retournée
Si la fonction réussit, la fonction retourne S_OK.
Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
| Code/valeur de retour | Description |
|---|---|
|
L’objet est déjà initialisé. |
|
L’heure spécifiée n’est pas valide. |
Remarques
En interne, InitializeFromCurrentTime appelle la fonction GetSystemTimeAsFileTime dans le SDK Windows. La date est stockée sous la forme d’une valeur réelle de 8 octets, représentant une date comprise entre le 1er janvier 1900 et le 31 décembre 9999 inclus. La valeur 2.0 représente le 1er janvier 1900 ; 3.0 représente le 2 janvier 1900. L’ajout de 1 à la valeur incrémente la date d’un jour. La partie fractionnaire de la valeur représente l’heure de la journée. Par conséquent, 2,5 représente 12 :00 le 1er janvier 1900 ; 3.25 représente 06 :00 le 2 janvier 1900.
Pour les dates comprises entre 1950 et 2049 inclus, la date et l’heure sont encodées utc-heure sous la forme YYMMDDHHMMSSS. Pour les dates antérieures à 1950 ou après 2049, l’heure généralisée encodée est utilisée. L’heure généralisée encodée se présente sous la forme AAAAMMDDHHMMSSMMM, à l’aide d’une année à quatre chiffres et est précise en millisecondes.
Appelez la méthode SetValueOnCertificate pour associer la propriété à un certificat. Pour récupérer la date, appelez la propriété BackedUpTime . Pour récupérer la valeur booléenne qui identifie si un certificat a été sauvegardé, appelez la propriété BackedUpValue .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certenroll.h |
| DLL | CertEnroll.dll |