Interfaz ICertServerPolicy (certif.h)
La interfaz ICertServerPolicy permite que el módulo de directiva se comunique con Servicios de certificados.
- 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) |