Метод IEnumCERTVIEWROW::EnumCertViewAttribute (certview.h)

Статья
08/22/2023

Метод EnumCertViewAttribute получает экземпляр последовательности перечисления атрибутов для текущей строки последовательности перечисления строк.

Синтаксис

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Параметры

[in] Flags

C++	Значение LONG . Должен равняться нулю.
VB	Значение Long . Должен равняться нулю.

[out] ppenum

Указатель на указатель типа IEnumCERTVIEWATTRIBUTE . После успешного завершения этого метода ppenum присваивается указатель типа IEnumCERTVIEWATTRIBUTE .

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

C++

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

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

VB

Возвращаемое значение является объектом последовательности перечисления атрибутов.

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

Чтобы сослаться на другую строку, вызовите один из следующих методов для перехода по последовательности перечисления строк:

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

Примеры

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

Требования

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