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

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

Sintaxe

HRESULT Skip(
  [in] LONG celt
);

Parâmetros

[in] celt

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

Retornar valor

VB

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

Um valor retornado de E_INVALIDARG indica que um valor negativo no parâmetro celt fez com que o índice de sequência de enumeração de coluna 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 dessa função, chame o método IEnumCERTVIEWCOLUMN::Next para referenciar a coluna atual na sequência de enumeração de coluna. Depois que essa segunda chamada for feita, as informações na coluna poderão ser obtidas chamando um dos seguintes métodos:

• IEnumCERTVIEWCOLUMN::GetName: recupera o nome não localizado da coluna.
• IEnumCERTVIEWCOLUMN::GetDisplayName: recupera o nome localizado da coluna.
• IEnumCERTVIEWCOLUMN::GetValue: recupera os dados na coluna.
• IEnumCERTVIEWCOLUMN::GetType: recupera o tipo de dados na coluna.
• IEnumCERTVIEWCOLUMN::GetMaxLength: recupera o comprimento máximo, em bytes, da coluna.

A sequência de enumeração de coluna 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

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

Confira também

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWCOLUMN::Reset

IEnumCERTVIEWCOLUMN:Next