Compartilhar via


Interface ICertRequest (certcli.h)

A interface ICertRequest fornece comunicações entre um aplicativo cliente ou intermediário e serviços de certificado.

Aplicativos cliente e intermediários podem chamar os métodos ICertRequest 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.

ICertRequest é definido em Certcli.h. No entanto, ao criar seu programa, use Certsrv.h como o arquivo de inclusão. Certcli.dll fornece a interface ICertRequest . As informações de tipo para essa interface também estão em Certclil.dll, que é fornecida 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 obter uma taxa de transferência melhor, o threading gratuito é recomendado.

Herança

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

Métodos

A interface ICertRequest tem esses métodos.

 
ICertRequest::GetCACertificate

Retorna o certificado de AC (autoridade de certificação) para o servidor dos Serviços de Certificados.
ICertRequest::GetCertificate

Retorna o certificado emitido para a solicitação como um certificado X.509 ou, opcionalmente, empacotado em um PKCS (Public Key Cryptography Standards)
ICertRequest::GetDispositionMessage

Obtém uma mensagem legível por humanos que fornece a disposição atual da solicitação de certificado.
ICertRequest::GetLastStatus

Obtém o último código de retorno para essa solicitação. Isso retorna as informações de código de erro, em vez da disposição da solicitação.
ICertRequest::GetRequestId

Obtém o número da solicitação interna atual para a solicitação e o certificado subsequente.
ICertRequest::RetrievePending

Recupera a disposição de um certificado status de uma solicitação anterior que pode ter retornado anteriormente CR_DISP_INCOMPLETE ou CR_DISP_UNDER_SUBMISSION.
ICertRequest::Submit

Envia uma solicitação para o servidor dos Serviços de Certificados.

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)