Compartir a través de


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)