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 incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Retourner le code/la valeur Descriptif
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
L’objet est déjà initialisé.
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)
L’heure spécifiée n’est pas valide.

Remarques

En interne, InitializeFromCurrentTime appelle la fonction GetSystemTimeAsFileTime dans le Kit de développement logiciel (SDK) Windows. La date est stockée sous forme de 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 par jour. La partie fractionnaire de la valeur représente l’heure du jour. 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, la date et l’heure sont encodées utc dans le formulaire YYMMDDHHMMSS. 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 est au format AAAAMMMMMMMMMMMMMMSSMMM, à l’aide d’une année à quatre chiffres et est précise à 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 .

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header certenroll.h
DLL CertEnroll.dll

Voir aussi

ICertProperty

ICertPropertyBackedUp