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

Статья
08/22/2023

Метод GetDispositionMessage получает удобочитаемое сообщение, которое дает текущую ликвидацию запроса на сертификат.

Обратите внимание, что сообщение, возвращаемое здесь, может содержать больше сведений, чем возвращенный код ошибки. Например, ICertRequest3::GetLastStatus может возвращать HRESULT, а GetDispositionMessage — подробную причину, указывающую причину отклонения запроса.

Синтаксис

HRESULT GetDispositionMessage(
  [out] BSTR *pstrDispositionMessage
);

Параметры

[out] pstrDispositionMessage

Указатель на BSTR , содержащий сообщение о ликвидации.

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

C++

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

После успешного выполнения этой функции параметру *pstrDispositionMessage присваивается значение BSTR , которое содержит удобочитаемое сообщение, которое дает текущую ликвидацию запроса на сертификат. Чтобы использовать этот метод, создайте переменную типа BSTR , задайте для переменной значение NULL и передайте адрес этой переменной как pstrDispositionMessage. Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

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

VB

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

Приложение вызовет этот метод, чтобы получить сообщение, полученное с сервера, с помощью предыдущего вызова ICertRequest3::Submit или ICertRequest3::RetrievePending. Кроме того, сообщение хранится в базе данных служб сертификатов и может просматриваться с помощью оснастки MMC центра сертификации (выберите столбец Сообщение о ликвидации запроса). Если сообщение содержит локализованный текст, оно было локализовано на сервере (на основе языкового стандарта сервера).

Примеры

#include <windows.h>
#include <stdio.h>
#include <Certcli.h>

    BSTR    bstrDispMsg = NULL;
    // pCertRequest is previously instantiated ICertRequest object 
    // pointer. Retrieve the disposition message for the 
    // previous request.
    hr = pCertRequest->GetDispositionMessage(&bstrDispMsg);
    if (FAILED(hr))
    {
        printf("Failed GetDispositionMessage [%x]\n", hr);
        goto error;
    }
    else
    {
        // Use the disposition message as needed...
    }

    // Done processing.

error:

    // Free BSTR values.
    if (NULL != bstrCA)
        SysFreeString(bstrCA);

    if (NULL != bstrDispMsg)
        SysFreeString(bstrDispMsg);

Требования

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