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

  • Artigo

O método Skip ignora um número especificado de atributos na sequência attribute-enumeration.

Sintaxe

HRESULT Skip(
  [in] LONG celt
);

Parâmetros

[in] celt

O número de atributos a serem ignoradas. Um valor positivo para o parâmetro celt faz com que a sequência attribute-enumeration pule para frente na sequência. Um valor negativo para o parâmetro celt faz com que a sequência attribute-enumeration pule para trás na sequência.

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 para o parâmetro celt fez com que o índice de sequência de enumeração de atributo 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 IEnumCERTVIEWATTRIBUTE::Next para referenciar o atributo atual na sequência attribute-enumeration. O nome e o valor do atributo podem ser acessados por meio dos seguintes métodos:

A sequência de enumeração de atributo mantém um índice interno baseado em zero. A chamada para o método Skip faz com que esse índice aumente ou diminua pelo número de atributos especificados no 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 IEnumCERTVIEWATTRIBUTE::Next será indefinido.

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

Exemplos

HRESULT  hr;
LONG     Index;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
// skip the next 5 attributes
hr = pEnumAttr->Skip(5);
if (S_OK == hr)
{
    // get the next attribute
    hr = pEnumAttr->Next(&Index);
    if (S_OK == hr)
    {
        // Use this attribute 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

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWATTRIBUTE::Reset

IEnumCERTVIEWATTRIBUTE:Next