Метод ICertRequest::GetLastStatus (certcli.h)

Статья
02/23/2024

Метод GetLastStatus получает последний код возврата для этого запроса. При этом возвращаются сведения о коде ошибки, а не о ликвидации запроса.

Синтаксис

HRESULT GetLastStatus(
  [out] LONG *pStatus
);

Параметры

[out] pStatus

Указатель на код состояния запроса.

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

C++

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

После успешного выполнения этой функции параметру *pStatus присваивается код результата последнего вызова ICertRequest3::Submit, ICertRequest3::RetrievePending или ICertRequest3::GetCACertificate.

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

VB

Возвращаемое значение — это код результата последнего вызова CCertRequest3.Submit, CCertRequest3.RetrievePending или CCertRequest3.GetCACertificate.

Значение, полученное GetLastStatus , зависит от последнего вызова ICertRequest3::Submit, ICertRequest3::RetrievePending или ICertRequest3::GetCACertificate. Если вызов одного из этих методов на сервере завершается сбоем, вызовите Метод GetLastStatus , чтобы получить номер ошибки. Некоторые сбои сервера (например, отклоненные запросы) возвращают S_OK и ликвидации, отличные от CR_DISP_ISSUED из вызова метода, и вы можете использовать GetLastStatus для получения конкретной причины сбоя. Если вызов одного из этих методов завершается успешно, последующий вызов GetLastStatus возвращает S_OK (ноль).

Кроме того, ликвидация запроса хранится в базе данных служб сертификатов и может быть просмотрен с помощью оснастки MMC центра сертификации (выберите столбец Ликвидация запроса).

Примеры

HRESULT    hrServer, hr;
// pCertRequest is previously instantiated
// ICertRequest object pointer.
hr = pCertRequest->GetLastStatus((LONG *) &hrServer);
if (FAILED(hr))
{
    printf("Failed GetLastStatus [%x]\n", hr);
    goto error;
}
else
{
    // Use the HRESULT value as needed...
}

Требования

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