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)