Partager via


Interface ICertRequest (certcli.h)

L’interface ICertRequest fournit des communications entre une application cliente ou intermédiaire et les services de certificat.

Les applications clientes et intermédiaires peuvent appeler les méthodes ICertRequest pour effectuer les tâches suivantes :

  • Envoyer une demande de certificat.
  • Récupérez la disposition, le dernier status et l’identificateur d’une demande.
  • Récupérez le certificat émis pour la demande.
  • Récupérez les certificats en attente pour les requêtes précédentes.
  • Récupérez le certificat d’autorité de certification pour le serveur des services de certificats.

ICertRequest est défini dans Certcli.h. Toutefois, lorsque vous créez votre programme, utilisez Certsrv.h comme fichier include. Certcli.dll fournit l’interface ICertRequest . 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 ICertRequest hérite de l’interface IDispatch . ICertRequest a également les types de membres suivants :

Méthodes

L’interface ICertRequest a ces méthodes.

 
ICertRequest ::GetCACertificate

Retourne le certificat d’autorité de certification pour le serveur des services de certification.
ICertRequest ::GetCertificate

Retourne le certificat émis pour la demande sous la forme d’un certificat X.509, ou éventuellement empaqueté dans un PKCS (Public Key Cryptography Standards)
ICertRequest ::GetDispositionMessage

Obtient un message lisible par l’homme qui donne la disposition actuelle de la demande de certificat.
ICertRequest ::GetLastStatus

Obtient le dernier code de retour pour cette requête. Cette opération retourne les informations de code d’erreur, plutôt que la disposition de la requête.
ICertRequest ::GetRequestId

Obtient le numéro de demande interne actuel pour la demande et le certificat suivant.
ICertRequest ::RetrievePending

Récupère les status de destruction d’un certificat à partir d’une requête antérieure qui a peut-être déjà retourné CR_DISP_INCOMPLETE ou CR_DISP_UNDER_SUBMISSION.
ICertRequest ::Submit

Envoie une demande au serveur des services de certificats.

Configuration requise

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