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

Статья
03/14/2023

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

Синтаксис

HRESULT Skip(
  [in] LONG celt
);

Параметры

[in] celt

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

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

VB

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

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

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

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

IEnumCERTVIEWCOLUMN::GetName: извлекает нелокализованное имя столбца.
IEnumCERTVIEWCOLUMN::GetDisplayName: извлекает локализованное имя столбца.
IEnumCERTVIEWCOLUMN::GetValue: извлекает данные в столбце.
IEnumCERTVIEWCOLUMN::GetType: извлекает тип данных в столбце.
IEnumCERTVIEWCOLUMN::GetMaxLength: извлекает максимальную длину столбца (в байтах).

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

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

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

Примеры

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column as needed.
    }
}

Требования

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

См. также раздел

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next

Поделиться через