ICertRequest2::GetIssuedCertificate method (certcli.h)

The GetIssuedCertificate method retrieves a certificate's disposition by specifying either the request ID or the certificate serial number.

This method is effectively the same as calling ICertRequest3::RetrievePending, with the additional capability of specifying a serial number for the certificate in question.


HRESULT GetIssuedCertificate(
  [in]          const BSTR strConfig,
  [in]          LONG       RequestId,
  [in]          const BSTR strSerialNumber,
  [out, retval] LONG       *pDisposition


[in] strConfig

Represents a valid configuration string for the Certificate Services server. The string can be either an HTTPS URL for an enrollment server or in the form ComputerName\CAName, where ComputerName is the network name of the server, and CAName is the common name of the certification authority, as entered during Certificate Services setup. For information about the configuration string name, see ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 and Windows XP:  An HTTPS URL is not supported as an input.

[in] RequestId

A LONG value that represents the certificate request ID in the Certificates Services database. Use –1 for this value if the serial number (passed in as strSerialNumber) is to be used instead of the request ID.

[in] strSerialNumber

A BSTR value that represents the certificate serial number, as issued by the CA. For strSerialNumber to be used, you must specify a value of –1 for RequestId.

[out, retval] pDisposition

A pointer to a LONG value that represents the certificate's disposition. The disposition is one of the following values.

Value Meaning
Request denied.
Request failed.
Request did not complete.
Certificate issued.
Certificate issued separately.
Request taken under submission.

Return value


If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.


The return value is a Long that represents the certificate's disposition.


Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header certcli.h (include Certsrv.h)
Library Certidl.lib
DLL Certcli.dll