Fonctions du fournisseur de services de chiffrement
Chacune des sections suivantes identifie une fonction exportée par Xenroll.dll qui peut être utilisée pour gérer un fournisseur de chiffrement. Chaque rubrique explique également comment utiliser CertEnroll.dll pour remplacer la fonction ou indique qu’il n’existe aucun mappage entre les deux bibliothèques :
- EnumAlgs
- enumContainersWStr
- enumProvidersWStr
- GetAlgNameWStr
- getProviderTypeWStr
- HashAlgID
- HashAlgorithmWStr
- ProviderFlags
- ProviderNameWStr
- ProviderType
- Rubriques connexes
EnumAlgs
La fonction EnumAlgs dans Xenroll.dll récupère une collection d’algorithmes de chiffrement.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer des informations sur les algorithmes pris en charge par un fournisseur de services de chiffrement (CSP) :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété CspInformations sur l’objet IX509PrivateKey récupéré à l’étape 4.
- Appelez la propriété CspAlgorithms sur un objet ICspInformation spécifique dans la collection ICspInformations récupérée à l’étape 5.
enumContainersWStr
La fonction enumContainersWStr dans Xenroll.dll récupère un conteneur de clés de la collection par index.
La bibliothèque CertEnroll.dll n’implémente pas directement cette fonctionnalité.
enumProvidersWStr
La fonction enumProvidersWStr dans Xenroll.dll récupère un fournisseur de solutions Cloud de la collection par index.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer la collection de conteneurs de chiffrement :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété CspInformations sur l’objet IX509PrivateKey récupéré à l’étape 4.
GetAlgNameWStr
La fonction GetAlgNameWStr dans Xenroll.dll récupère le nom d’un algorithme de chiffrement.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer le nom de l’algorithme :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété Algorithm sur l’objet IX509PrivateKey pour récupérer l’identificateur d’objet de l’algorithme.
- Appelez la propriété FriendlyName sur l’interface IObjectId pour récupérer le nom complet de l’algorithme.
getProviderTypeWStr
La fonction getProviderTypeWStr dans Xenroll.dll récupère le type de fournisseur de chiffrement.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer le type de fournisseur :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété ProviderType sur l’objet IX509PrivateKey récupéré à l’étape 4.
HashAlgID
La fonction HashAlgID dans Xenroll.dll récupère une valeur entière qui contient l’ID de l’algorithme utilisé pour signer une requête.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer l’algorithme de hachage :
- Récupérez une interface IX509SignatureInformation en appelant la propriété SignatureInformation sur une requête PKCS #10 ou CMC ou la propriété SignerCertificate sur une requête PKCS #7 .
- Appelez la propriété HashAlgorithm sur l’objet d’informations de signature pour récupérer l’identificateur d’objet de l’algorithme de hachage.
HashAlgorithmWStr
La fonction HashAlgorithmWStr dans Xenroll.dll spécifie ou récupère une valeur de chaîne qui identifie l’algorithme de hachage utilisé pour signer une demande.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer l’algorithme de hachage :
- Récupérez une interface IX509SignatureInformation en appelant la propriété SignatureInformation sur une requête PKCS #10 ou CMC ou la propriété SignerCertificate sur une requête PKCS #7.
- Appelez la propriété HashAlgorithm sur l’objet d’informations de signature pour récupérer l’identificateur d’objet de l’algorithme de hachage.
- Appelez la propriété FriendlyName sur l’interface IObjectId retournée à l’étape 2 pour récupérer le nom complet de l’algorithme.
ProviderFlags
La fonction ProviderFlags dans Xenroll.dll spécifie ou récupère les indicateurs utilisés lors de l’acquisition d’un handle pour un fournisseur de solutions Cloud.
La bibliothèque CertEnroll.dll ne mappe pas parfaitement cette fonction, mais vous pouvez obtenir des informations de propriété enrichies à partir de l’objet d’inscription et de la clé privée. Pour plus d’informations, examinez les propriétés exposées par les interfaces IX509Enrollment et IX509PrivateKey .
ProviderNameWStr
La fonction ProviderNameWStr dans Xenroll.dll spécifie ou récupère le nom d’un fournisseur de solutions Cloud.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer le nom du fournisseur :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété ProviderName sur l’objet IX509PrivateKey récupéré à l’étape 4.
ProviderType
La fonction ProviderType dans Xenroll.dll spécifie ou récupère une valeur entière qui identifie le type du fournisseur de solutions Cloud.
Lorsque vous utilisez CertEnroll.dll, vous pouvez effectuer les actions suivantes pour récupérer le type de fournisseur :
- Appelez la propriété Request sur un objet IX509Enrollment existant.
- Appelez la méthode GetInnerRequest sur la requête retournée à l’étape 1 pour récupérer la requête la plus interne.
- Appelez QueryInterface sur l’objet IX509CertificateRequest retourné à l’étape 2 pour effectuer une conversion en objet IX509CertificateRequestPkcs10 .
- Appelez la propriété PrivateKey sur la requête PKCS #10.
- Appelez la propriété ProviderType sur l’objet IX509PrivateKey récupéré à l’étape 4.
Rubriques connexes
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour