Compartilhar via


Interface ICertRequest2 (certcli.h)

A interface ICertRequest2 é uma das duas 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 ICertRequest2 para executar as seguintes tarefas:

  • Enviar 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 .

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

Métodos

A interface ICertRequest2 tem esses métodos.

 
ICertRequest2::GetCAProperty

Recupera um valor de propriedade para a AC (autoridade de certificação). (ICertRequest2.GetCAProperty)
ICertRequest2::GetCAPropertyDisplayName

Recupera o nome de exibição da propriedade para uma propriedade de autoridade de certificação (AC).
ICertRequest2::GetCAPropertyFlags

Recupera os sinalizadores de propriedade de uma propriedade de autoridade de certificação (AC).
ICertRequest2::GetErrorMessageText

Recupera o texto da mensagem de erro para um código de erro HRESULT.
ICertRequest2::GetFullResponseProperty

Recupera os dados de resposta em cache retornados pelo servidor.
ICertRequest2::GetIssuedCertificate

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

Requisitos

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