Interfaz ICertAdmin (certadm.h)

La interfaz ICertAdmin proporciona funcionalidad de administración para clientes autorizados correctamente.

La interfaz ICertAdmin se usa para realizar las siguientes tareas:

• Autorizar o denegar una solicitud de certificado.
• Revocar un certificado emitido.
• Desencadene la generación de una lista de revocación de certificados (CRL).
• Obtenga la CRL actual para el servidor.
• Determine si un certificado es válido.

Al usar la interfaz ICertAdmin , tiene acceso de solo escritura para solicitar atributos y extensiones de certificado, pero no tiene acceso directo a otras propiedades de solicitud y certificado.

ICertAdmin se define en Certadm.h. Sin embargo, al crear un programa, use Certsrv.h como archivo de inclusión. Certadm.dll, por otro lado, proporciona la implementación de la interfaz ICertAdmin . La información de tipo de esta interfaz también está en Certadml.dll, que se incluye con el Kit de desarrollo de software (SDK) de plataforma.

Las tareas de administración usan DCOM. El código que llama a este método de interfaz tal como se define en una versión anterior de Certadm.h se ejecutará en servidores basados en Windows siempre que el cliente y el servidor ejecuten el mismo sistema operativo Windows.

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 ICertAdmin hereda de la interfaz IDispatch . ICertAdmin también tiene estos tipos de miembros:

Métodos

La interfaz ICertAdmin tiene estos métodos.

ICertAdmin::D enyRequest Deniega una solicitud de certificado especificada que está pendiente.
ICertAdmin::GetCRL Recupera la lista de revocación de certificados (CRL) actual para la entidad de certificación (CA) de Servicios de certificados.
ICertAdmin::GetRevocationReason Devuelve el motivo por el que se revoca un certificado. Este método se definió por primera vez en la interfaz ICertAdmin.
ICertAdmin::ImportCertificate Toma un certificado emitido previamente e lo importa a la base de datos de la entidad de certificación (CA). Este método se definió por primera vez en la interfaz ICertAdmin.
ICertAdmin::IsValidCertificate Comprueba el certificado con la clave de la entidad de certificación (CA) y comprueba que el certificado no se ha revocado. Este método se definió por primera vez en la interfaz ICertAdmin.
ICertAdmin::P ublishCRL Envía una solicitud a la entidad de certificación (CA) de Servicios de certificados para publicar una nueva lista de revocación de certificados (CRL). Este método se introdujo por primera vez en la interfaz ICertAdmin.
ICertAdmin::ResubmitRequest Envía la solicitud de certificado especificada al módulo de directiva para la entidad de certificación especificada. Este método se introdujo por primera vez en la interfaz ICertAdmin.
ICertAdmin::RevokeCertificate Revoca un certificado en una fecha especificada o inmediatamente. Este método se definió por primera vez en la interfaz ICertAdmin.
ICertAdmin::SetCertificateExtension Agrega una nueva extensión al certificado emitido en respuesta a una solicitud de certificado. Este método se definió por primera vez mediante la interfaz ICertAdmin.
ICertAdmin::SetRequestAttributes Establece atributos en la solicitud de certificado pendiente especificada. Este método se definió por primera vez en la interfaz ICertAdmin.

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	certadm.h (incluya Certsrv.h)