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

  • Artículo

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

Sintaxis

HRESULT Skip(
  [in] LONG celt
);

Parámetros

[in] celt

Número de atributos que se van a omitir. Un valor positivo para el parámetro celt hace que la secuencia de enumeración de atributos omita hacia delante en la secuencia. Un valor negativo para el parámetro celt hace que la secuencia de enumeración de atributos 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 atributos 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

Después de completar correctamente este método, llame al método IEnumCERTVIEWATTRIBUTE::Next para hacer referencia al atributo actual en la secuencia de enumeración de atributos. Se puede acceder al nombre y el valor del atributo a través de los métodos siguientes:

La secuencia de enumeración de atributos 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 atributos especificados 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 IEnumCERTVIEWATTRIBUTE::Next no está definido.

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

Ejemplos

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

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 (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Next