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

Artigo
08/22/2023

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

Se o método for bem-sucedido, o método retornará S_OK.

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:

A sequência de enumeração de linha mantém um índice interno baseado em zero. A chamada para o método Skip faz com que esse índice aumente ou diminua com base na configuração do parâmetro celt .

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


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll