Método ICertRequest3::GetIssuedCertificate2 (certcli.h)

  • Artigo

O método 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.

Sintaxe

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          BSTR strSerialNumber,
  [out, retval] LONG *pDisposition
);

Parâmetros

[in] strConfig

Representa uma cadeia de caracteres de configuração válida para o servidor dos Serviços de Certificados . A cadeia de caracteres pode ser uma URL HTTPS para um servidor de registro ou no formulário ComputerName\CAName, em que ComputerName é o nome de rede do servidor e CAName é o nome comum da autoridade de certificação, conforme inserido durante a instalação dos Serviços de Certificado. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para uma URL HTTPS como entrada.

[in] strRequestId

Um valor BSTR que representa a ID da solicitação de certificado no banco de dados do Certificates Services. Defina esse parâmetro como NULL se o número de série (passado como strSerialNumber) for usado em vez da ID da solicitação.

Use o método ICertRequest3::GetRequestIdString para obter a cadeia de caracteres de ID da solicitação.

[in] strSerialNumber

Um valor BSTR que representa o número de série do certificado, conforme emitido pela AC. A cadeia de caracteres deve especificar o número de série como um número par de dígitos hexadecimal. Se necessário, um zero pode ser prefixado no número para produzir um número par de dígitos. No entanto, não mais de um zero à esquerda pode ser usado.

O valor strSerialNumber só é usado quando strRequestId é definido como NULL.

[out, retval] pDisposition

Um ponteiro para um valor LONG que representa a disposição do certificado. A disposição é um dos valores a seguir.

Valor Significado
CR_DISP_DENIED
 Solicitação negada.
CR_DISP_ERROR
 Falha na solicitação.
CR_DISP_INCOMPLETE
 A solicitação não foi concluída.
CR_DISP_ISSUED
 Certificado emitido.
CR_DISP_ISSUED_OUT_OF_BAND
 Certificado emitido separadamente.
CR_DISP_UNDER_SUBMISSION
 Solicitação feita em envio.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um Long que representa a disposição do 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)
Biblioteca Certidl.lib
DLL Certcli.dll

Confira também

CCertRequest

ICertRequest3