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

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.

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

Confira também

CCertRequest

ICertRequest3