Método ICertRequest2::GetIssuedCertificate (certcli.h)

Artigo
02/26/2024

O método GetIssuedCertificate recupera a disposição de um certificado especificando a ID da solicitação ou o número de série do certificado.

Esse método é efetivamente o mesmo que chamar ICertRequest3::RetrievePending, com a capacidade adicional de especificar um número de série para o certificado em questão.

Sintaxe

HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const 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 formato 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 Certificados. 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] RequestId

Um valor LONG que representa a ID da solicitação de certificado no banco de dados dos Serviços de Certificados. Use –1 para esse valor se o número de série (passado como strSerialNumber) for usado em vez da ID da solicitação.

[in] strSerialNumber

Um valor BSTR que representa o número de série do certificado, conforme emitido pela AC. Para que strSerialNumber seja usado, você deve especificar um valor de –1 para RequestId.

[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 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)
Biblioteca	Certidl.lib
DLL	Certcli.dll

Share via