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

Статья
08/22/2023

Метод Next перемещается к следующей строке в последовательности перечисления строк.

Синтаксис

HRESULT Next(
  [out] LONG *pIndex
);

Параметры

[out] pIndex

Указатель на переменную, содержащую значение индекса следующей строки, на которую ссылается ссылка. Если для перечисления больше нет строк, для этой переменной будет задано значение –1. Этот метод завершается ошибкой , если pIndex имеет значение NULL.

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

C++

Если метод завершается успешно, метод возвращает S_OK и на следующую строку теперь ссылается последовательность перечисления строк. Если строк для перечисления больше нет, возвращается S_FALSE, а pIndex имеет значение –1.

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

VB

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

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

Циклическое перебор всех строк в последовательности перечисления может быть ресурсоемким для вычислений в зависимости от задействованного запроса и размера последовательности.

Примеры

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

Требования

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