Interface ICertServerPolicy (certif.h)
A interface ICertServerPolicy permite que o módulo de política se comunique com os Serviços de Certificados.
- 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) |