Partager via

ICertPropertyBackedUp ::Initialize, méthode (certenroll.h)

  • Article

La méthode Initialize initialise l’objet à partir d’une valeur booléenne et d’une date.

Syntaxe

HRESULT Initialize(
  [in] VARIANT_BOOL BackedUpValue,
  [in] DATE         Date
);

Paramètres

[in] BackedUpValue

Variable VARIANT_BOOL qui identifie si le certificat a été sauvegardé.

[in] Date

Variable DATE qui identifie la date de la dernière sauvegarde d’un certificat.

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
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

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 HEURE UTC sous la forme AAAMMDDHHMMSSS. Pour les dates antérieures à 1950 ou postérieures à 2049, une heure généralisée encodée est utilisée. Le temps généralisé encodé prend la forme AAAAMMDDHHMMSSMMM, à l’aide d’une année à quatre chiffres, et est précis à 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

Voir aussi

ICertProperty

ICertPropertyBackedUp