Interface ICertSrvSetup (casetup.h)
L’interface ICertSrvSetup définit les fonctionnalités permettant d’installer et de désinstaller des rôles d’autorité de certification et d’inscription web d’autorité de certification sur un ordinateur des services de certification .
Microsoft fournit une implémentation de cette interface dans la classe CCertSrvSetup . Pour l’installation, vous devez appeler la méthode InitializeDefaults avant d’accéder à des propriétés ou d’appeler d’autres méthodes sur l’objet CCertSrvSetup .
En C++, vous créez une instance de cette interface en appelant la fonction CoCreateInstance avec l’identificateur de classe CLSID_CCertSrvSetup.
Windows Server 2008 Standard : Les services suivants ne sont pas disponibles :
- Service répondeur en ligne
- Service d’inscription de périphériques réseau
- Les modèles V2 ne sont pas pris en charge ; par conséquent, l’inscription automatique n’est pas prise en charge.
- Les agents d’inscription déléguée ne sont pas pris en charge.
- La séparation des rôles n’est pas prise en charge.
Héritage
L’interface ICertSrvSetup hérite de l’interface IDispatch. ICertSrvSetup a également les types de membres suivants :
Méthodes
L’interface ICertSrvSetup comporte ces méthodes.
| ICertSrvSetup ::CAImportPFX Importe un certificat d’autorité de certification et sa clé privée associée dans le magasin d’ordinateurs local. |
| ICertSrvSetup ::get_CAErrorId Obtient l’ID des informations d’erreur supplémentaires relatives à une spécification d’autorité de certification (CA) ayant échoué. |
| ICertSrvSetup ::get_CAErrorString Obtient les données de chaîne pour obtenir des informations d’erreur supplémentaires relatives à une spécification d’autorité de certification (CA) ayant échoué. |
| ICertSrvSetup ::GetCASetupProperty Obtient une valeur de propriété pour une configuration d’autorité de certification . |
| ICertSrvSetup ::GetExistingCACertificates Obtient la collection d’objets CertSrvSetupKeyInformation qui représentent des certificats d’autorité de certification valides actuellement installés sur l’ordinateur. |
| ICertSrvSetup ::GetHashAlgorithmList Obtient la liste des algorithmes de hachage pris en charge par le fournisseur de services de chiffrement (CSP) spécifié pour un algorithme de clé de signature asymétrique. |
| ICertSrvSetup ::GetKeyLengthList Obtient la liste des longueurs de clé prises en charge par le fournisseur de services de chiffrement (CSP) spécifié. (ICertSrvSetup.GetKeyLengthList) |
| ICertSrvSetup ::GetPrivateKeyContainerList Obtient la liste des noms de conteneurs de clés stockés par le fournisseur de services de chiffrement (CSP) spécifié pour les algorithmes de clé de signature asymétrique. |
| ICertSrvSetup ::GetProviderNameList Obtient la liste des fournisseurs de services de chiffrement (CSP) qui fournissent des algorithmes de signature de clé asymétrique sur l’ordinateur. |
| ICertSrvSetup ::GetSupportedCATypes Obtient les types d’autorités de certification qui peuvent être installées sur un ordinateur sous le contexte de l’appelant. |
| ICertSrvSetup ::InitializeDefaults Initialise un objet CCertSrvSetup avec des valeurs par défaut pour permettre l’installation du rôle Autorité de certification. |
| ICertSrvSetup ::Install Installe un rôle tel que configuré dans l’objet CCertSrvSetup. |
| ICertSrvSetup ::IsPropertyEditable Indique à l’appelant si une propriété spécifiée peut être modifiée. |
| ICertSrvSetup ::P ostUnInstall N’est pas implémenté et est réservé à une utilisation ultérieure. |
| ICertSrvSetup ::P reUnInstall Enregistre temporairement les informations d’état spécifiques au rôle, puis désinstalle le rôle. |
| ICertSrvSetup ::SetCADistinguishedName Définit un nom commun d’autorité de certification (CA) et un suffixe de nom unique facultatif. |
| ICertSrvSetup ::SetCASetupProperty Définit une valeur de propriété pour une configuration d’autorité de certification (CA). |
| ICertSrvSetup ::SetDatabaseInformation Définit les informations relatives à la base de données pour le rôle d’autorité de certification . |
| ICertSrvSetup ::SetParentCAInformation Définit les informations d’autorité de certification parente pour une configuration d’autorité de certification subordonnée. |
| ICertSrvSetup ::SetWebCAInformation Définit les informations d’autorité de certification pour le rôle Inscription web de l’autorité de certification. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | casetup.h |