Interface ICertAdmin (certadm.h)

A interface ICertAdmin fornece funcionalidade de administração para clientes autorizados corretamente.

A interface ICertAdmin é usada para executar as seguintes tarefas:

• Autorizar ou negar uma solicitação de certificado.
• Revogar um certificado emitido.
• Dispare a geração de uma CRL ( lista de certificados revogados ).
• Obtenha a CRL atual para o servidor.
• Determine se um certificado é válido.

Ao usar a interface ICertAdmin , você tem acesso somente gravação para solicitar atributos e extensões de certificado, mas sem acesso direto a outras propriedades de solicitação e certificado.

ICertAdmin é definido em Certadm.h. No entanto, ao criar um programa, use Certsrv.h como o arquivo de inclusão. Certadm.dll, por outro lado, fornece a implementação da interface ICertAdmin . As informações de tipo para essa interface também estão em Certadml.dll, que é fornecida com o SDK (Platform Software Development Kit).

As tarefas de administração usam o DCOM. O código que chama esse método de interface conforme definido em uma versão anterior do Certadm.h será executado em servidores baseados no Windows, desde que o cliente e o servidor estejam executando o mesmo sistema operacional Windows.

As interfaces dos Serviços de Certificados dão suporte a modelos apartment-threading e free-threading. Para obter uma taxa de transferência melhor, o threading gratuito é recomendado.

Herança

A interface ICertAdmin herda da interface IDispatch . ICertAdmin também tem estes tipos de membros:

Métodos

A interface ICertAdmin tem esses métodos.

ICertAdmin::D enyRequest Nega uma solicitação de certificado especificada pendente.
ICertAdmin::GetCRL Recupera a CRL (lista de certificados revogados) atual para a AC (autoridade de certificação) dos Serviços de Certificados.
ICertAdmin::GetRevocationReason Retorna o motivo pelo qual um certificado foi revogado. Esse método foi definido pela primeira vez na interface ICertAdmin.
ICertAdmin::ImportCertificate Usa um certificado emitido anteriormente e o importa para o banco de dados da AC (autoridade de certificação). Esse método foi definido pela primeira vez na interface ICertAdmin.
ICertAdmin::IsValidCertificate Verifica o certificado em relação à chave de AC (autoridade de certificação) e verifica se o certificado não foi revogado. Esse método foi definido pela primeira vez na interface ICertAdmin.
ICertAdmin::P ublishCRL Envia uma solicitação à AC (autoridade de certificação) dos Serviços de Certificados para publicar uma nova CRL (lista de certificados revogados). Esse método foi introduzido pela primeira vez na interface ICertAdmin.
ICertAdmin::ResubmitRequest Envia a solicitação de certificado especificada para o módulo de política para a autoridade de certificação especificada. Esse método foi introduzido pela primeira vez na interface ICertAdmin.
ICertAdmin::RevokeCertificate Revoga um certificado em uma data especificada ou imediatamente. Esse método foi definido pela primeira vez na interface ICertAdmin.
ICertAdmin::SetCertificateExtension Adiciona uma nova extensão ao certificado emitido em resposta a uma solicitação de certificado. Esse método foi definido pela primeira vez pela interface ICertAdmin.
ICertAdmin::SetRequestAttributes Define atributos na solicitação de certificado pendente especificada. Esse método foi definido pela primeira vez na interface ICertAdmin.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certadm.h (inclua Certsrv.h)