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

Статья
02/28/2024

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

Синтаксис

HRESULT Skip(
  [in] LONG celt
);

Параметры

[in] celt

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

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

VB

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

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

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

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

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

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

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

Примеры

HRESULT  hr;
LONG     Index;

// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
// skip the next 5 extensions
hr = pEnumExt->Skip(5);
if (S_OK == hr)
{
    // get the next extension
    hr = pEnumExt->Next(&Index);
    if (S_OK == hr)
    {
        // Use this extension as needed.
    }
}

Требования

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