Partager via

Interface ICertRequest2 (certcli.h)

  • Article

L’interface ICertRequest2 est l’une des deux interfaces qui fournissent des communications entre une application cliente ou intermédiaire et les services de certificats.

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

  • Envoyer une demande de certificat.
  • Récupérer la disposition, la dernière 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 certification.
  • Récupérez la valeur de la propriété d’autorité de certification, le nom d’affichage et tous les indicateurs associés à la propriété.
  • Récupérez les données de réponse mises en cache retournées par le serveur.
  • Récupérer le texte du message d’erreur d’un code d’erreur HRESULT .

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

Méthodes

L’interface ICertRequest2 a ces méthodes.

 
ICertRequest2 ::GetCAProperty

Récupère une valeur de propriété pour l’autorité de certification (CA). (ICertRequest2.GetCAProperty)
ICertRequest2 ::GetCAPropertyDisplayName

Récupère le nom d’affichage de la propriété d’une propriété d’autorité de certification (CA).
ICertRequest2 ::GetCAPropertyFlags

Récupère les indicateurs de propriété d’une propriété d’autorité de certification (CA).
ICertRequest2 ::GetErrorMessageText

Récupère le texte du message d’erreur d’un code d’erreur HRESULT.
ICertRequest2 ::GetFullResponseProperty

Récupère les données de réponse mises en cache retournées par le serveur.
ICertRequest2 ::GetIssuedCertificate

Récupère la disposition d’un certificat en spécifiant l’ID de demande ou le numéro de série du certificat.

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