Interfaz ICertRequest3 (certcli.h)
La interfaz ICertRequest3 es una de las tres interfaces que proporcionan comunicaciones entre una aplicación cliente o intermedia y servicios de certificado.
Las aplicaciones cliente e intermedias pueden llamar a los métodos ICertRequest3 para realizar las siguientes tareas:
- Envíe una solicitud de certificado.
- Recupere la disposición, el último estado y el identificador de una solicitud.
- Recupere el certificado emitido para la solicitud.
- Recupere los certificados pendientes para las solicitudes anteriores.
- Recupere el certificado de entidad de certificación (CA) para el servidor de Servicios de certificados.
- Recupere el valor de la propiedad ca, el nombre para mostrar y las marcas asociadas a la propiedad .
- Recupere los datos de respuesta almacenados en caché devueltos por el servidor.
- Recupere el texto del mensaje de error para un código de error HRESULT .
ICertRequest3 se define en Certcli.h. Sin embargo, al crear el programa, use Certsrv.h como archivo de inclusión. Certcli.dll proporciona la interfaz ICertRequest3 . La información de tipo de esta interfaz también está en Certcli.dll, que se incluye con el Kit de desarrollo de software (SDK) de plataforma.
Las interfaces de Servicios de certificados admiten modelos de subprocesos de apartamento y subprocesos libres. Para mejorar el rendimiento, se recomienda el subproceso libre.
Herencia
La interfaz ICertRequest3 hereda de ICertRequest2, ICertRequest e IDispatch. ICertRequest3 también tiene estos tipos de miembros:
Métodos
La interfaz ICertRequest3 tiene estos métodos.
| ICertRequest3::GetIssuedCertificate2 Recupera la disposición de un certificado especificando la cadena de identificador de solicitud o el número de serie del certificado. |
| ICertRequest3::GetRefreshPolicy Devuelve un valor que indica si la directiva de inscripción de certificados en caché de un cliente no está actualizada y debe actualizarse. |
| ICertRequest3::GetRequestIdString Obtiene el número de solicitud interno actual, con formato de cadena, para la solicitud y el certificado posterior. |
| ICertRequest3::SetCredential Establece la credencial usada para ponerse en contacto con el servicio web de inscripción de certificados. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 R2 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certcli.h (incluya Certsrv.h) |