Метод ICertServerPolicy::GetRequestAttribute (certif.h)

Статья
08/22/2023

Метод GetRequestAttribute возвращает именованный атрибут из запроса.

Синтаксис

HRESULT GetRequestAttribute(
  [in]  const BSTR strAttributeName,
  [out] BSTR       *pstrAttributeValue
);

Параметры

[in] strAttributeName

Имя извлекаемого атрибута.

[out] pstrAttributeValue

Указатель на значение BSTR , которое будет содержать значение атрибута.

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

C++

Если метод завершается успешно, метод возвращает S_OK, а параметру *pstrAttributeValue присваивается значение BSTR , содержащее значение атрибута.

Чтобы использовать этот метод, создайте переменную типа BSTR, задайте для переменной значение NULL и передайте адрес этой переменной как pstrAttributeValue.

Завершив использование BSTR, освободите его, вызвав функцию SysFreeString .

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

VB

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

Имя свойства	Тип	Описание
Задача	String	Строка запроса, сопровождающая запрос.
ExpectedChallenge	String	Если строка запроса неверна, сервер установит для этого атрибута запроса значение ожидаемого запроса, чтобы можно было диагностировать сбой.

Примеры

BSTR     bstrAttribValue = NULL;
HRESULT  hr;

// Get the request attribute.
// bstrAttribName is BSTR assigned by EnumerateAttributes.
// pCertServerPolicy has been used to call SetContext previously.
hr = pCertServerPolicy->GetRequestAttribute(bstrAttribName,
                                            &bstrAttribValue);

if (FAILED(hr))
{
    printf("Failed GetRequestAttribute [%x]\n", hr);
    goto error;
}
else
{

    // Successful call. Use the bstrAttribValue as needed.
    // ...
}

// Done processing. Free BSTR.
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

Требования

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

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

ICertServerPolicy

ICertServerPolicy::SetContext

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