Partager via


Interface ICspStatus (certenroll.h)

Un objet ICspStatus contient des informations sur une paire fournisseur/algorithme de chiffrement. L’objet est principalement utilisé par le contrôle d’inscription de certificat pour permettre à un utilisateur de sélectionner les fournisseurs de chiffrement et les algorithmes à utiliser lors de la création d’une demande de certificat. Il peut être récupéré, seul ou dans une collection ICspStatuses , en appelant les propriétés ou méthodes suivantes :

Property/Method Interface Description
GetCspStatusFromOperations ICspInformation Crée un objet ICspStatus pour le premier algorithme pris en charge qui est cohérent avec un identificateur d’objet d’algorithme (OID) et un type d’algorithme spécifiés.
GetCspStatusesFromOperations ICspInformations Crée une collection ICspStatuses pour un type d’algorithme spécifié et des informations de fournisseur facultatives.
Note Le contrôle d’inscription de certificat utilise une collection ICspStatuses uniquement pour la sélection de l’algorithme de clé privée asymétrique (chiffrement, signature et échange de clés).
 
GetCspStatusFromProviderName ICspInformations Crée un objet ICspStatus pour un fournisseur hérité par nom de fournisseur et les opérations de clé prises en charge.
CspStatus IX509PrivateKey Spécifie ou récupère un objet ICspStatus . L’objet est généralement créé pendant le processus d’inscription.
GetCspStatuses IX509CertificateRequestPkcs10 Crée une collection ICspStatuses qui contient toutes les paires fournisseur/algorithme cohérentes avec l’utilisation prévue de la clé privée, comme spécifié par l’appelant.
CspStatuses IX509CertificateRequestPkcs10 Crée une collection ICspStatuses qui contient toutes les paires fournisseur/algorithme cohérentes avec l’utilisation prévue de la clé privée identifiée par l’objet IX509PrivateKey associé à la demande de certificat.
 

Étant donné que les fournisseurs de chiffrement prennent généralement en charge plusieurs algorithmes, plusieurs objets ICspStatus peuvent être créés et retournés lorsque vous appelez l’une des propriétés ou méthodes précédentes qui retournent une collection. L’illustration suivante le montre :

Structure de la collection ICspStatuses affichant des objets ICspStatus individuels

Vous pouvez utiliser la propriété EnrollmentStatus sur un objet ICspStatus pour récupérer un objet IX509EnrollmentStatus qui définit les propriétés suivantes :

  • La propriété Display spécifie si la paire fournisseur/algorithme peut être affichée dans une interface utilisateur.
  • La propriété Selected spécifie ou récupère une valeur qui indique si la status d’un élément spécifique est surveillée pendant le processus d’inscription.
  • La propriété Status identifie les status du processus d’inscription.

Héritage

L’interface ICspStatus hérite de l’interface IDispatch. ICspStatus a également les types de membres suivants :

Méthodes

L’interface ICspStatus possède ces méthodes.

 
ICspStatus ::get_CspAlgorithm

Récupère un objet ICspAlgorithm qui contient des informations sur un algorithme pris en charge par le fournisseur.
ICspStatus ::get_CspInformation

Récupère un objet ICspInformation qui contient des informations générales sur le fournisseur.
ICspStatus ::get_DisplayName

Récupère une chaîne qui contient le nom du fournisseur, le nom de l’algorithme et les opérations qui peuvent être effectuées par l’algorithme.
ICspStatus ::get_EnrollmentStatus

Récupère un objet IX509EnrollmentStatus qui contient des informations sur l’inscription du certificat.
ICspStatus ::get_Ordinal

Spécifie ou récupère la position de l’objet ICspStatus dans la collection ICspStatuses. (Obtenir)
ICspStatus ::Initialize

Initialise l’objet à partir d’un fournisseur de chiffrement et d’un algorithme associé.
ICspStatus ::p ut_Ordinal

Spécifie ou récupère la position de l’objet ICspStatus dans la collection ICspStatuses. (Put)

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

Voir aussi

CertEnroll Interfaces

ICspStatuses

IDispatch