Interface ICertAdmin (certadm.h)

L’interface ICertAdmin fournit des fonctionnalités d’administration pour les clients correctement autorisés.

L’interface ICertAdmin est utilisée pour effectuer les tâches suivantes :

• Autoriser ou refuser une demande de certificat.
• Révoquer un certificat émis.
• Déclencher la génération d’une liste de révocation de certificats (CRL).
• Obtenez la liste de révocation de certificats actuelle pour le serveur.
• Déterminez si un certificat est valide.

Lorsque vous utilisez l’interface ICertAdmin , vous disposez d’un accès en écriture seule aux attributs de demande et aux extensions de certificat, mais pas d’accès direct aux autres propriétés de demande et de certificat.

ICertAdmin est défini dans Certadm.h. Toutefois, lorsque vous créez un programme, utilisez Certsrv.h comme fichier include. Certadm.dll, en revanche, fournit l’implémentation de l’interface ICertAdmin . Les informations de type pour cette interface sont également dans Certadml.dll, qui est fourni avec le Kit de développement logiciel (SDK) de plateforme.

Les tâches d’administration utilisent DCOM. Le code qui appelle cette méthode d’interface telle que définie dans une version antérieure de Certadm.h s’exécute sur les serveurs Windows tant que le client et le serveur exécutent tous les deux le même système d’exploitation Windows.

Les interfaces des services de certificats prennent en charge à la fois les modèles de threads d’appartement et de thread libre. Pour un meilleur débit, le thread gratuit est recommandé.

Héritage

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

Méthodes

L’interface ICertAdmin a ces méthodes.

ICertAdmin ::D enyRequest Refuse une demande de certificat spécifiée qui est en attente.
ICertAdmin ::GetCRL Récupère la liste de révocation de certificats (CRL) actuelle pour l’autorité de certification des services de certificats.
ICertAdmin ::GetRevocationReason Retourne la raison pour laquelle un certificat a été révoqué. Cette méthode a d’abord été définie dans l’interface ICertAdmin.
ICertAdmin ::ImportCertificate Prend un certificat émis précédemment et l’importe dans la base de données de l’autorité de certification. Cette méthode a d’abord été définie dans l’interface ICertAdmin.
ICertAdmin ::IsValidCertificate Vérifie le certificat par rapport à la clé d’autorité de certification et vérifie que le certificat n’a pas été révoqué. Cette méthode a d’abord été définie dans l’interface ICertAdmin.
ICertAdmin ::P ublishCRL Envoie une demande à l’autorité de certification des services de certificats pour publier une nouvelle liste de révocation de certificats (CRL). Cette méthode a été introduite pour la première fois dans l’interface ICertAdmin.
ICertAdmin ::ResubmitRequest Envoie la demande de certificat spécifiée au module de stratégie pour l’autorité de certification spécifiée. Cette méthode a été introduite pour la première fois dans l’interface ICertAdmin.
ICertAdmin ::RevokeCertificate Révoque un certificat à une date spécifiée ou immédiatement. Cette méthode a d’abord été définie dans l’interface ICertAdmin.
ICertAdmin ::SetCertificateExtension Ajoute une nouvelle extension au certificat émis en réponse à une demande de certificat. Cette méthode a d’abord été définie par l’interface ICertAdmin.
ICertAdmin ::SetRequestAttributes Définit les attributs dans la demande de certificat en attente spécifiée. Cette méthode a d’abord été définie dans l’interface ICertAdmin.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certadm.h (include Certsrv.h)