Método IEnumCERTVIEWEXTENSION::Skip (certview.h)

Artículo
08/22/2023

El método Skip omite un número especificado de extensiones en la secuencia de enumeración de extensiones.

Sintaxis

HRESULT Skip(
  [in] LONG celt
);

Parámetros

[in] celt

Número de extensiones que se van a omitir. Un valor positivo para el parámetro celt hace que la secuencia de enumeración de extensión se omita hacia delante en la secuencia. Un valor negativo para el parámetro celt hace que la secuencia de enumeración de extensión omita hacia atrás en la secuencia.

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Un valor devuelto de E_INVALIDARG indica que un valor negativo para el parámetro celt hizo que el índice de secuencia de enumeración de extensión se convirtiera en menor que cero.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Una vez completado correctamente este método, llame al método IEnumCERTVIEWEXTENSION::Next para hacer referencia a la extensión actual en la secuencia de enumeración de extensión. Se puede tener acceso al nombre, las marcas y el valor de la extensión a través de los métodos siguientes:

La secuencia de enumeración de extensión mantiene un índice interno de base cero. La llamada al método Skip hace que este índice aumente o disminuya por el número de extensiones especificadas en el parámetro celt .

Si un valor negativo del parámetro celt hace que el índice sea menor que cero, el comportamiento de las llamadas posteriores a IEnumCERTVIEWEXTENSION::Next es indefinido.

Si un valor positivo del parámetro celt hace que el índice supere la última extensión de la secuencia de enumeración, se producirá un error en una llamada posterior al método IEnumCERTVIEWEXTENSION::Next .

Ejemplos

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.
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluye Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll