Interface ICertServerPolicy (certif.h)

L’interface ICertServerPolicy permet au module de stratégie de communiquer avec les services de certificats.

Note Les services de certificat communiquent avec le module de stratégie via l’interface ICertPolicy2 .

 

L’interface ICertServerPolicy est exportée par le moteur de serveur et est appelée par le module de stratégie pour effectuer les tâches suivantes :

• Spécifiez la demande de certificat utilisée comme contexte actuel pour les opérations suivantes.
• Énumérez et récupérez les extensions (y compris les indicateurs d’extension) d’une demande de certificat et définissez les extensions du certificat émis.
• Énumérez et récupérez les attributs de requête.
• Récupérez les propriétés de la demande de certificat.
• Récupérez et définissez les propriétés de certificat.

À partir du moment où la méthode ICertPolicy ::VerifyRequest est appelée jusqu’à ce qu’elle soit retournée, la demande non résolue et le certificat en cours de construction sont accessibles via un objet de données Context. Étant donné que le module de stratégie peut ajouter ou remplacer des propriétés de requête en appelant ICertServerPolicy ::SetCertificateProperty, les propriétés de certificat peuvent différer des propriétés de requête.

ICertServerPolicy est défini dans Certif.h. Toutefois, lorsque vous créez votre programme, utilisez Certsrv.h comme fichier include. Certcli.dll fournit l’interface ICertServerPolicy . Les informations de type pour cette interface sont é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 threads d’appartement et de thread libre. Pour un meilleur débit, le thread gratuit est recommandé.

Héritage

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

Méthodes

L’interface ICertServerPolicy comporte ces méthodes.

ICertServerPolicy ::EnumerateAttributes Récupère le nom de l’attribut actuel et déplace le pointeur d’énumération interne vers l’attribut suivant.
ICertServerPolicy ::EnumerateAttributesClose Libère les ressources connectées à l’énumération d’attributs.
ICertServerPolicy ::EnumerateAttributesSetup Initialise le pointeur d’énumération interne vers le premier attribut de requête associé au contexte actuel. (ICertServerPolicy.EnumerateAttributesSetup)
ICertServerPolicy ::EnumerateExtensions Récupère l’identificateur d’objet (OID) de l’extension actuelle et déplace le pointeur d’énumération interne vers l’extension suivante.
ICertServerPolicy ::EnumerateExtensionsClose Libère les ressources connectées à l’énumération d’extension.
ICertServerPolicy ::EnumerateExtensionsSetup Initialise le pointeur d’énumération interne vers la première extension de certificat associée au contexte actuel. (ICertServerPolicy.EnumerateExtensionsSetup)
ICertServerPolicy ::GetCertificateExtension Récupère une extension de certificat spécifique.
ICertServerPolicy ::GetCertificateExtensionFlags Récupère les indicateurs associés à l’extension acquise par l’appel le plus récent à GetCertificateExtension.
ICertServerPolicy ::GetCertificateProperty Retourne une propriété nommée à partir d’un certificat. (ICertServerPolicy.GetCertificateProperty)
ICertServerPolicy ::GetRequestAttribute Retourne un attribut nommé à partir d’une requête.
ICertServerPolicy ::GetRequestProperty Récupère une propriété spécifique à partir d’une requête.
ICertServerPolicy ::SetCertificateExtension Ajoute une nouvelle extension au certificat.
ICertServerPolicy ::SetCertificateProperty Pour définir une propriété associée à un certificat.
ICertServerPolicy ::SetContext Spécifie la demande à utiliser comme contexte pour les appels suivants aux services de certificats.

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	certif.h (include Certsrv.h)

Voir aussi

ICertAdmin ::ResubmitRequest

ICertAdmin ::SetRequestAttributes

ICertPolicy ::VerifyRequest

ICertRequest

ICertRequest ::Submit

IDispatch