Compartilhar via


Interface ICertServerPolicy (certif.h)

A interface ICertServerPolicy permite que o módulo de política se comunique com os Serviços de Certificados.

Nota Os Serviços de Certificados se comunicam com o módulo de política por meio da interface ICertPolicy2 .
 
A interface ICertServerPolicy é exportada pelo mecanismo de servidor e é chamada pelo módulo de política para executar as seguintes tarefas:
  • Especifique qual solicitação de certificado é usada como o contexto atual para operações subsequentes.
  • Enumerar e recuperar as extensões (incluindo sinalizadores de extensão) de uma solicitação de certificado e definir as extensões do certificado emitido.
  • Enumerar e recuperar atributos de solicitação.
  • Recuperar propriedades de solicitação de certificado.
  • Recupere e defina as propriedades do certificado.

A partir do momento em que o método ICertPolicy::VerifyRequest é chamado até que ele retorne, a solicitação e o certificado não resolvidos em construção podem ser acessados por meio de um objeto de dados Context. Como o módulo de política pode adicionar ou substituir propriedades de solicitação chamando ICertServerPolicy::SetCertificateProperty, as propriedades do certificado podem ser diferentes das propriedades da solicitação.

ICertServerPolicy é definido em Certif.h. No entanto, ao criar seu programa, use Certsrv.h como o arquivo de inclusão. Certcli.dll fornece a interface ICertServerPolicy . As informações de tipo para essa interface também estão em Certclil.dll, que é fornecido com o SDK (Platform Software Development Kit).

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

Herança

A interface ICertServerPolicy herda da interface IDispatch . ICertServerPolicy também tem esses tipos de membros:

Métodos

A interface ICertServerPolicy tem esses métodos.

 
ICertServerPolicy::EnumerateAttributes

Recupera o nome do atributo atual e move o ponteiro de enumeração interna para o próximo atributo.
ICertServerPolicy::EnumerateAttributesClose

Libera os recursos conectados à enumeração de atributo.
ICertServerPolicy::EnumerateAttributesSetup

Inicializa o ponteiro de enumeração interna para o primeiro atributo de solicitação associado ao contexto atual. (ICertServerPolicy.EnumerateAttributesSetup)
ICertServerPolicy::EnumerateExtensions

Recupera o OID (identificador de objeto) da extensão atual e move o ponteiro de enumeração interna para a próxima extensão.
ICertServerPolicy::EnumerateExtensionsClose

Libera os recursos conectados à enumeração de extensão.
ICertServerPolicy::EnumerateExtensionsSetup

Inicializa o ponteiro de enumeração interna para a primeira extensão de certificado associada ao contexto atual. (ICertServerPolicy.EnumerateExtensionsSetup)
ICertServerPolicy::GetCertificateExtension

Recupera uma extensão de certificado específica.
ICertServerPolicy::GetCertificateExtensionFlags

Recupera os sinalizadores associados à extensão adquirida pela chamada mais recente para GetCertificateExtension.
ICertServerPolicy::GetCertificateProperty

Retorna uma propriedade nomeada de um certificado. (ICertServerPolicy.GetCertificateProperty)
ICertServerPolicy::GetRequestAttribute

Retorna um atributo nomeado de uma solicitação.
ICertServerPolicy::GetRequestProperty

Recupera uma propriedade específica de uma solicitação.
ICertServerPolicy::SetCertificateExtension

Adiciona uma nova extensão ao certificado.
ICertServerPolicy::SetCertificateProperty

Para definir uma propriedade associada a um certificado.
ICertServerPolicy::SetContext

Especifica a solicitação a ser usada como o contexto para chamadas subsequentes aos Serviços de Certificado.

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 certif.h (inclua Certsrv.h)

Confira também

ICertAdmin::ResubmitRequest

ICertAdmin::SetRequestAttributes

ICertPolicy::VerifyRequest

ICertRequest

ICertRequest::Submit

IDispatch