Partager via

Interface ICertConfig (certcli.h)

  • Article

L’interface ICertConfig fournit des fonctionnalités permettant de récupérer les données de configuration publiques (spécifiées lors de l’installation du client) pour un serveur des services de certificats.

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

  • Énumérez les chaînes de configuration d’un serveur des services de certificat dans le point de configuration.
  • Récupérez la configuration par défaut d’un serveur Des services de certificats.
  • Récupérez les détails d’une configuration de serveur des services de certificats spécifique.
  • Réinitialisez la configuration d’un serveur de services de certificats.

Pour chaque installation des services de certificats, ces données de configuration publiques résident dans le fichier Certsrv.txt, qui existe dans le dossier partagé, Active Directory ou les deux. Tout serveur configuré pour publier ses informations de configuration dans Certsrv.txt est visible par ICertConfig.

ICertConfig est défini dans Certcli.h. Toutefois, lorsque vous créez votre programme, utilisez Certsrv.h comme fichier include. Certcli.dll fournit l’interface ICertConfig . Les informations de type pour cette interface se trouve également dans Certclil.dll, qui est fourni avec le Kit de développement logiciel (SDK) de plateforme.

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

Héritage

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

Méthodes

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

 
ICertConfig ::GetConfig

Récupère la chaîne de configuration d’un serveur des services de certificat. Cette méthode a d’abord été définie dans l’interface ICertConfig.
ICertConfig ::GetField

Obtient un champ spécifique à partir de l’enregistrement actif de la base de données de configuration. Cette méthode a d’abord été définie dans l’interface ICertConfig.
ICertConfig ::Next

Récupère l’index de la configuration de serveur des services de certificats disponible suivante dans le point de configuration. Cette méthode a d’abord été définie dans l’interface ICertConfig.
ICertConfig ::Reset

Réinitialise l’état de la requête de configuration pour qu’il pointe vers la configuration du serveur des services de certificat indexée sur le point de configuration spécifié. Cette méthode a d’abord été définie dans l’interface ICertConfig.

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 certcli.h (inclure Certsrv.h)