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

Artículo
03/14/2023

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

Sintaxis

HRESULT Skip(
  [in] LONG celt
);

Parámetros

[in] celt

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

Valor devuelto

VB

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

Un valor devuelto de E_INVALIDARG indica que el parámetro celt se estableció en un número negativo que hizo que el índice de secuencia de enumeración de fila 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 IEnumCERTVIEWROW::Skip para hacer referencia a la fila actual de la secuencia de enumeración de filas. Después de realizar esta segunda llamada, se pueden enumerar las columnas, atributos y extensiones asociadas con el certificado de la fila mediante los métodos de las interfaces siguientes:

La secuencia de enumeración de filas mantiene un índice interno basado en cero. La llamada al método Skip hace que este índice aumente o disminuya en función de la configuración del 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 Next no está definido.

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

Ejemplos

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
HRESULT  hr;
LONG     Index;
// Reposition the row enumerator to the beginning of the rows.
hr = pEnumRow->Reset();
if (FAILED(hr))
{
    printf("Unable to reset pEnumRow\n");
    goto error;
}
// Skip some rows.
hr = pEnumRow->Skip(5);
if (FAILED(hr))
{
    printf("Unable to skip rows\n");
    goto error;
}

// Get the next row.
hr = pEnumRow->Next(&Index);
if (S_OK == hr)
{
    // Use this row as needed.
}

error:

if (NULL != pEnumRow)
    pEnumRow->Release();

Requisitos


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