Interface ICertRequest3 (certcli.h)

  • Artigo

A interface ICertRequest3 é uma das três interfaces que fornecem comunicações entre um aplicativo cliente ou intermediário e os Serviços de Certificado.

Aplicativos cliente e intermediários podem chamar os métodos ICertRequest3 para executar as seguintes tarefas:

  • Envie uma solicitação de certificado.
  • Recupere a disposição, a última status e o identificador de uma solicitação.
  • Recupere o certificado emitido para a solicitação.
  • Recuperar certificados pendentes para solicitações anteriores.
  • Recupere o certificado de AC (autoridade de certificação ) para o servidor dos Serviços de Certificados.
  • Recupere o valor da propriedade ca, o nome de exibição e todos os sinalizadores associados à propriedade .
  • Recupere os dados de resposta em cache retornados pelo servidor.
  • Recupere o texto da mensagem de erro para um código de erro HRESULT .

ICertRequest3 é definido em Certcli.h. No entanto, ao criar seu programa, use Certsrv.h como o arquivo de inclusão. Certcli.dll fornece a interface ICertRequest3 . As informações de tipo para essa interface também estão em Certcli.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 ICertRequest3 herda de ICertRequest2, ICertRequest e IDispatch. ICertRequest3 também tem esses tipos de membros:

Métodos

A interface ICertRequest3 tem esses métodos.

 
ICertRequest3::GetIssuedCertificate2

Recupera a disposição de um certificado especificando a cadeia de caracteres de ID da solicitação ou o número de série do certificado.
ICertRequest3::GetRefreshPolicy

Retorna um valor que indica se a política de registro de certificado armazenado em cache de um cliente está desatualizada e precisa ser atualizada.
ICertRequest3::GetRequestIdString

Obtém o número da solicitação interna atual, formatado como uma cadeia de caracteres, para a solicitação e o certificado subsequente.
ICertRequest3::SetCredential

Define a credencial usada para entrar em contato com o Serviço Web de Registro de Certificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certcli.h (inclua Certsrv.h)

Confira também

ICertRequest

ICertRequest2

IDispatch