Interfaz ICertRequest3 (certcli.h)

  • Artículo

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)

Consulte también

ICertRequest

ICertRequest2

IDispatch