Interfaz ICertRequest (certcli.h)

La interfaz ICertRequest proporciona comunicaciones entre una aplicación cliente o intermedia y servicios de certificado.

Las aplicaciones cliente e intermedias pueden llamar a los métodos ICertRequest para realizar las siguientes tareas:

• Enviar 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.

ICertRequest se define en Certcli.h. Sin embargo, al crear el programa, use Certsrv.h como archivo de inclusión. Certcli.dll proporciona la interfaz ICertRequest . La información de tipo de esta interfaz también está en Certclil.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 de subprocesos libres. Para mejorar el rendimiento, se recomienda el subproceso libre.

Herencia

La interfaz ICertRequest hereda de la interfaz IDispatch . ICertRequest también tiene estos tipos de miembros:

Métodos

La interfaz ICertRequest tiene estos métodos.

ICertRequest::GetCACertificate Devuelve el certificado de entidad de certificación (CA) para el servidor de Servicios de certificados.
ICertRequest::GetCertificate Devuelve el certificado emitido para la solicitud como certificado X.509 o, opcionalmente, empaquetado en estándares de criptografía de clave pública (PKCS)
ICertRequest::GetDispositionMessage Obtiene un mensaje legible que proporciona la disposición actual de la solicitud de certificado.
ICertRequest::GetLastStatus Obtiene el último código devuelto para esta solicitud. Esto devuelve la información del código de error, en lugar de la eliminación de la solicitud.
ICertRequest::GetRequestId Obtiene el número de solicitud interno actual para la solicitud y el certificado posterior.
ICertRequest::RetrievePending Recupera el estado de disposición de un certificado de una solicitud anterior que puede haber devuelto previamente CR_DISP_INCOMPLETE o CR_DISP_UNDER_SUBMISSION.
ICertRequest::Submit Envía una solicitud al servidor de Servicios de certificados.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certcli.h (incluya Certsrv.h)