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

O método Skip ignora um número especificado de linhas na sequência de enumeração de linha.

Sintaxe

HRESULT Skip(
  [in] LONG celt
);

Parâmetros

[in] celt

O número de linhas a serem ignoradas. Um valor positivo para o parâmetro celt faz com que a sequência de enumeração de linha pule para frente na sequência de enumeração. Um valor negativo para o parâmetro celt faz com que a sequência de enumeração de linha pule para trás na sequência de enumeração.

Valor retornado

VB

Um valor retornado de E_INVALIDARG indica que o parâmetro celt foi definido como um número negativo que fez com que o índice de sequência de enumeração de linha se tornasse menor que zero.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Após a conclusão bem-sucedida desse método, chame o método IEnumCERTVIEWROW::Skip para referenciar a linha atual na sequência de enumeração de linha. Depois que essa segunda chamada for feita, as colunas, os atributos e as extensões associados ao certificado na linha poderão ser enumerados usando os métodos das seguintes interfaces:

• IEnumCERTVIEWCOLUMN
• IEnumCERTVIEWATTRIBUTE
• IEnumCERTVIEWEXTENSION

Se um valor negativo do parâmetro celt fizer com que o índice seja menor que zero, o comportamento das chamadas subsequentes para Next será indefinido.

Se um valor positivo do parâmetro celt fizer com que o índice exceda a última linha na sequência de enumeração, uma chamada subsequente para o método Next falhará.

Exemplos

// 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

Confira também

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset