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

Статья
08/22/2023

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

Синтаксис

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Параметры

[in] Flags

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

[out, retval] ppenum

Указатель на указатель типа IEnumCERTVIEWEXTENSION .

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

C++

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

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

VB

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

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

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

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

Примеры

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

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

Требования

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