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

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.

Retornar valor

C++

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

Requisitos