Interface ICertRequest3 (certcli.h)
L’interface ICertRequest3 est l’une des trois 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 ICertRequest3 pour effectuer les tâches suivantes :
- Envoyez 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 .
ICertRequest3 est défini dans Certcli.h. Toutefois, lorsque vous créez votre programme, utilisez Certsrv.h comme fichier include. Certcli.dll fournit l’interface ICertRequest3 . Les informations de type pour cette interface se trouve également dans Certcli.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 ICertRequest3 hérite d’ICertRequest2, ICertRequest et IDispatch. ICertRequest3 possède également les types de membres suivants :
Méthodes
L’interface ICertRequest3 comporte ces méthodes.
| ICertRequest3 ::GetIssuedCertificate2 Récupère la disposition d’un certificat en spécifiant la chaîne d’ID de demande ou le numéro de série du certificat. |
| ICertRequest3 ::GetRefreshPolicy Retourne une valeur qui indique si la stratégie d’inscription de certificats mis en cache d’un client est obsolète et doit être actualisée. |
| ICertRequest3 ::GetRequestIdString Obtient le numéro de requête interne actuel, mis en forme sous forme de chaîne, pour la demande et le certificat suivant. |
| ICertRequest3 ::SetCredential Définit les informations d’identification utilisées pour contacter le service web d’inscription de certificats. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certcli.h (inclure Certsrv.h) |