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

Статья
08/22/2023

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

Синтаксис

HRESULT Skip(
  [in] LONG celt
);

Параметры

[in] celt

Количество пропустимых строк. Положительное значение параметра celt приводит к пропуску последовательности перечисления строк в последовательности перечисления. Отрицательное значение параметра celt приводит к пропуску последовательности перечисления строк назад в последовательности перечисления.

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

VB

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

Возвращаемое значение E_INVALIDARG указывает, что параметру celt присвоено отрицательное число, из-за чего индекс последовательности перечисления строк становится меньше нуля.

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

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

Последовательность перечисления строк поддерживает внутренний индекс с нуля. Вызов метода Skip приводит к увеличению или уменьшению этого индекса в зависимости от параметра celt .

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

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

Примеры

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

Требования


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