Partager via


Méthode ICspStatus ::get_EnrollmentStatus (certenroll.h)

La propriété EnrollmentStatus récupère un objet IX509EnrollmentStatus qui contient des informations sur l’inscription du certificat.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_EnrollmentStatus(
  IX509EnrollmentStatus **ppValue
);

Paramètres

ppValue

Valeur de retour

None

Remarques

Cette propriété renvoie un objet IX509EnrollmentStatus . Cet objet est généralement rempli lorsque vous créez une demande de certificat PKCS #10. Les trois propriétés suivantes retournées par cet objet fournissent des informations sur la paire fournisseur/algorithme représentée par un objet ICspStatus :

  • La propriété Display spécifie si le fournisseur et l’algorithme doivent être affichés dans une interface utilisateur.
  • La propriété Selected spécifie si le fournisseur et l’algorithme peuvent être utilisés pour créer une paire de clés pour une demande de certificat.
  • La propriété Status spécifie si le fournisseur et l’algorithme ont été ignorés ou ont entraîné une erreur lors de l’initialisation de la demande.

Pour comprendre l’importance de ces propriétés, supposons qu’une demande de certificat est basée sur un modèle qui spécifie un fournisseur et un algorithme particuliers. Les propriétés Display et Status pour cette paire fournisseur/algorithme sont activées. Pour d’autres objets ICspStatus , l’une de ces propriétés ou les deux ne sont peut-être pas activées. Pour obtenir des exemples plus complets, consultez la propriété Ordinal .

La propriété Status a la valeur EnrollUnknown lorsque l’objet IX509EnrollmentStatus est créé pour la première fois. Si aucune paire fournisseur/algorithme n’est sélectionnée, le status peut être défini sur InscrireSkipped. Le status sera défini sur EnrollError si la création de clé échoue pour le fournisseur et l’algorithme sélectionnés lors de l’initialisation du certificat.

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

ICspStatus

ICspStatuses