Поделиться через

Метод ICertRequest2::GetIssuedCertificate (certcli.h)

  • Статья

Метод GetIssuedCertificate извлекает ликвидацию сертификата, указывая идентификатор запроса или серийный номер сертификата.

Этот метод фактически совпадает с вызовом ICertRequest3::RetrievePending с дополнительной возможностью указания серийного номера для соответствующего сертификата.

Синтаксис

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

Параметры

[in] strConfig

Представляет допустимую строку конфигурации для сервера служб сертификатов. Строка может быть URL-адресом HTTPS для сервера регистрации или в форме Имя_\компьютера CAName, где ComputerName — сетевое имя сервера, а CAName — общее имя центра сертификации, указанное при настройке служб сертификации. Сведения об имени строки конфигурации см. в разделе ICertConfig.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: URL-адрес HTTPS не поддерживается в качестве входных данных.

[in] RequestId

Значение LONG , представляющее идентификатор запроса сертификата в базе данных Служб сертификатов. Используйте –1 для этого значения, если вместо идентификатора запроса следует использовать серийный номер (передаваемый как strSerialNumber).

[in] strSerialNumber

Значение BSTR , представляющее серийный номер сертификата, выданный ЦС. Для использования strSerialNumber необходимо указать значение –1 в параметре RequestId.

[out, retval] pDisposition

Указатель на значение LONG , представляющее ликвидацию сертификата. Ликвидация является одним из следующих значений.

Значение Значение
CR_DISP_DENIED
 Запрос отклонен.
CR_DISP_ERROR
 Сбой запроса.
CR_DISP_INCOMPLETE
 Запрос не завершен.
CR_DISP_ISSUED
 Выданный сертификат.
CR_DISP_ISSUED_OUT_OF_BAND
 Сертификат, выданный отдельно.
CR_DISP_UNDER_SUBMISSION
 Запрос, принятый при отправке.

Возвращаемое значение

C++

Если метод выполнен успешно, метод возвращает S_OK.

Если метод завершается сбоем, он возвращает значение HRESULT , указывающее на ошибку. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

VB

Возвращаемое значение — long , представляющее ликвидацию сертификата.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header certcli.h (включая Certsrv.h)
Библиотека Certidl.lib
DLL Certcli.dll