Метод ICertRequest3::GetIssuedCertificate2 (certcli.h)

Статья
02/23/2024

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

Синтаксис

HRESULT GetIssuedCertificate2(
  [in]          BSTR strConfig,
  [in]          BSTR strRequestId,
  [in]          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] strRequestId

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

Используйте метод ICertRequest3::GetRequestIdString , чтобы получить строку идентификатора запроса.

[in] strSerialNumber

Значение BSTR , представляющее серийный номер сертификата, выданный ЦС. Строка должна указывать серийный номер в виде четного числа шестнадцатеричных цифр. При необходимости можно задать нулевые префиксы к числу, чтобы получить четное число цифр. Однако можно использовать не более одного нуля в начале.

Значение strSerialNumber используется только в том случае , если параметру strRequestId присвоено значение NULL.

[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 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	certcli.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certcli.dll

См. также раздел

CCertRequest

ICertRequest3

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