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