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

Статья
03/14/2023

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

Синтаксис

HRESULT Skip(
  [in] LONG celt
);

Параметры

[in] celt

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

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

VB

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

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

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

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

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

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

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

Примеры

HRESULT  hr;
LONG     Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
    // get the next attribute
    hr = pEnumAttr->Next(&Index);
    if (S_OK == hr)
    {
        // Use this attribute as needed.
    }
}

Требования

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

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

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Next

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