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

  • Article

La méthode Initialize initialise l’objet à partir d’une clé privée.

Syntaxe

HRESULT Initialize(
  [in] IX509PrivateKey *pValue
);

Paramètres

[in] pValue

Pointeur vers une interface IX509PrivateKey qui représente la clé privée.

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
CERTSRV_E_PROPERTY_EMPTY
 Le pointeur IX509PrivateKey a la valeur NULL.
ERROR_ARITHMETIC_OVERFLOW
 Le nom unique du conteneur et le nom du fournisseur sont trop longs.

Remarques

Appelez la méthode SetValueOnCertificate pour associer la propriété à un certificat. Appelez la propriété PrivateKey pour récupérer la clé.

La méthode Initialize ouvre la clé privée et vérifie que les propriétés IX509PrivateKey suivantes sont définies :

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

ICertPropertyKeyProvInfo