Compartir a través de


Interfaz ICertServerPolicy (certif.h)

La interfaz ICertServerPolicy permite que el módulo de directiva se comunique con Servicios de certificados.

Nota Servicios de certificados se comunica con el módulo de directiva a través de la interfaz ICertPolicy2 .
 
El motor de servidor exporta la interfaz ICertServerPolicy y el módulo de directivas llama a esta para realizar las siguientes tareas:
  • Especifique qué solicitud de certificado se usa como contexto actual para las operaciones posteriores.
  • Enumere y recupere las extensiones (incluidas las marcas de extensión) de una solicitud de certificado y establezca las extensiones del certificado emitido.
  • Enumerar y recuperar atributos de solicitud.
  • Recupere las propiedades de la solicitud de certificado.
  • Recupere y establezca las propiedades del certificado.

Desde el momento en que se llama al método ICertPolicy::VerifyRequest hasta que se devuelve, se puede acceder a la solicitud sin resolver y al certificado en construcción a través de un objeto de datos Context. Dado que el módulo de directiva puede agregar o invalidar las propiedades de solicitud mediante una llamada a ICertServerPolicy::SetCertificateProperty, las propiedades del certificado pueden diferir de las propiedades de solicitud.

ICertServerPolicy se define en Certif.h. Sin embargo, al crear el programa, use Certsrv.h como archivo de inclusión. Certcli.dll proporciona la interfaz ICertServerPolicy . 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 subprocesos libres. Para mejorar el rendimiento, se recomienda el subproceso libre.

Herencia

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

Métodos

La interfaz ICertServerPolicy tiene estos métodos.

 
ICertServerPolicy::EnumerateAttributes

Recupera el nombre del atributo actual y mueve el puntero de enumeración interno al atributo siguiente.
ICertServerPolicy::EnumerateAttributesClose

Libera los recursos conectados con la enumeración de atributos.
ICertServerPolicy::EnumerateAttributesSetup

Inicializa el puntero de enumeración interno al primer atributo de solicitud asociado al contexto actual. (ICertServerPolicy.EnumerateAttributesSetup)
ICertServerPolicy::EnumerateExtensions

Recupera el identificador de objeto (OID) de la extensión actual y mueve el puntero de enumeración interna a la siguiente extensión.
ICertServerPolicy::EnumerateExtensionsClose

Libera los recursos conectados con la enumeración de extensiones.
ICertServerPolicy::EnumerateExtensionsSetup

Inicializa el puntero de enumeración interna a la primera extensión de certificado asociada al contexto actual. (ICertServerPolicy.EnumerateExtensionsSetup)
ICertServerPolicy::GetCertificateExtension

Recupera una extensión de certificado específica.
ICertServerPolicy::GetCertificateExtensionFlags

Recupera las marcas asociadas a la extensión adquirida por la llamada más reciente a GetCertificateExtension.
ICertServerPolicy::GetCertificateProperty

Devuelve una propiedad con nombre de un certificado. (ICertServerPolicy.GetCertificateProperty)
ICertServerPolicy::GetRequestAttribute

Devuelve un atributo con nombre de una solicitud.
ICertServerPolicy::GetRequestProperty

Recupera una propiedad específica de una solicitud.
ICertServerPolicy::SetCertificateExtension

Agrega una nueva extensión al certificado.
ICertServerPolicy::SetCertificateProperty

Para establecer una propiedad asociada a un certificado.
ICertServerPolicy::SetContext

Especifica la solicitud que se va a usar como contexto para las llamadas posteriores a Servicios de certificados.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certif.h (incluya Certsrv.h)

Consulte también

ICertAdmin::ResubmitRequest

ICertAdmin::SetRequestAttributes

ICertPolicy::VerifyRequest

ICertRequest

ICertRequest::Submit

IDispatch