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

Статья
08/22/2023

Метод 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

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