ICertPropertyBackedUp ::Initialize, méthode (certenroll.h)
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 |
|---|---|
|
L’objet est déjà initialisé. |
|
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 |