Метод IEnumCERTVIEWATTRIBUTE::GetValue (certview.h)

Статья
08/22/2023

Метод GetValue извлекает значение текущего атрибута в последовательности перечисления атрибутов.

Синтаксис

HRESULT GetValue(
  [out] BSTR *pstrOut
);

Параметры

[out] pstrOut

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

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

C++

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

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

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

VB

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

Если последовательность перечисления атрибутов не ссылается на допустимый атрибут, GetValue завершится ошибкой. Используйте один из следующих методов для перехода по перечислению:

IEnumCERTVIEWATTRIBUTE::Reset: перемещается в начало последовательности перечисления.
IEnumCERTVIEWATTRIBUTE::Next: перемещается к следующему атрибуту в последовательности перечисления.
IEnumCERTVIEWATTRIBUTE::Skip: пропускает указанное количество атрибутов.

Примеры

BSTR    bstrAttribValue = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetValue(&bstrAttribValue);
if (S_OK != hr)
    printf("Failed call to GetValue - %x\n", hr);
else
    printf("Attribute value is %ws\n",bstrAttribValue);

// free memory when done
if (NULL != bstrAttribValue)
    SysFreeString(bstrAttribValue);

Требования

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