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

Статья
02/23/2024

Метод GetValue извлекает значение данных, содержащееся в текущем столбце в последовательности перечисления столбцов.

Синтаксис

HRESULT GetValue(
  [in]  LONG    Flags,
  [out] VARIANT *pvarValue
);

Параметры

[in] Flags

Идентификатор, обозначающий формат выходных данных для полученных данных. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
CV_OUT_BASE64	BASE64 без BEGIN/END
CV_OUT_BASE64HEADER	BASE64 с BEGIN CERTIFICATE и END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 с BEGIN NEW CERTIFICATE REQUEST и END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 с BEGIN X509 CRL и END X509 CRL
CV_OUT_BINARY	Двоичные данные
CV_OUT_HEX	Шестнадцатеричная строка
CV_OUT_HEXADDR	Шестнадцатеричная строка с адресом или смещением
CV_OUT_HEXASCII	Шестнадцатеричная строка с ASCII
CV_OUT_HEXASCIIADDR	Шестнадцатеричная строка с ASCII и адресом и смещением

[out] pvarValue

Указатель на значение типа VARIANT , содержащее столбец данных. Этот метод завершается ошибкой , если pvarValue имеет значение NULL. После успешного завершения этого метода pvarValue содержит данные в столбце . Вызывающий объект отвечает за вызов VariantClear по завершении работы с данными.

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

C++

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

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

VB

Возвращаемое значение представляет собой значение Variant , представляющее данные в столбце.

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

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

Примеры

HRESULT     hr;
VARIANT     var;
SYSTEMTIME  systime;

VariantInit(&var);

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetValue(CV_OUT_HEX, &var);
if ( FAILED (hr) )
{
    printf("Failed GetValue - %x\n", hr);
    goto error;
}
switch( var.vt )
{
    case VT_EMPTY:
        printf( "VT_EMPTY\n" );
        break;
    case VT_BSTR:
        printf("%ws\n", var.bstrVal );
        break;
    case VT_DATE:
        VariantTimeToSystemTime( var.date, &systime );
        printf("%d.%d.%d %02d:%02d:%02d\n",
               systime.wMonth,
               systime.wDay,
               systime.wYear,
               systime.wHour,
               systime.wMinute,
               systime.wSecond );
        break;
    case VT_I2:
        printf("%d\n", var.iVal );
        break;
    case VT_I4:
        printf("%d\n", var.lVal );
        break;
    default:
        printf("type is:%i\n", var.vt );
        break;
}
// done processing, clear resources
VariantClear( &var );

Требования

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