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

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

Sintaxis

HRESULT Skip(
  [in] LONG celt
);

Parámetros

[in] celt

Número de columnas que se van a omitir. Un valor positivo para el parámetro celt hace que la secuencia de enumeración de columnas se omita hacia delante en la secuencia de enumeración. Un valor negativo hace que la enumeración de columnas 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 un valor negativo en el parámetro celt hizo que el índice de secuencia de enumeración de columnas 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 completada correctamente esta función, llame al método IEnumCERTVIEWCOLUMN::Next para hacer referencia a la columna actual en la secuencia de enumeración de columnas. Una vez realizada esta segunda llamada, se puede obtener la información de la columna llamando a uno de los métodos siguientes:

• IEnumCERTVIEWCOLUMN::GetName: recupera el nombre no localizado de la columna.
• IEnumCERTVIEWCOLUMN::GetDisplayName: recupera el nombre localizado de la columna.
• IEnumCERTVIEWCOLUMN::GetValue: recupera los datos de la columna.
• IEnumCERTVIEWCOLUMN::GetType: recupera el tipo de datos de la columna.
• IEnumCERTVIEWCOLUMN::GetMaxLength: recupera la longitud máxima, en bytes, de la columna.

La secuencia de enumeración de columnas mantiene un índice interno de base 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 es indefinido.

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

HRESULT  hr;
LONG     Index;

// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
// skip the next five columns
hr = pEnumCol->Skip(5);
if (S_OK == hr) 
{
    // get the next column
    hr = pEnumCol->Next(&Index);
    if (S_OK == hr)
    {
        // Use this column 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

Consulte también

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next