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

Artigo
02/28/2024

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

Sintaxe

HRESULT Skip(
  [in] LONG celt
);

Parâmetros

[in] celt

O número de extensões a serem ignoradas. Um valor positivo para o parâmetro celt faz com que a sequência extension-enumeration pule para frente na sequência. Um valor negativo para o parâmetro celt faz com que a sequência extension-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 extensão 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 IEnumCERTVIEWEXTENSION::Next para fazer referência à extensão atual na sequência de enumeração de extensão. O nome, os sinalizadores e o valor da extensão podem ser acessados por meio dos seguintes métodos:

A sequência de enumeração de extensão 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 extensões especificadas 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 IEnumCERTVIEWEXTENSION::Next será indefinido.

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

Exemplos

HRESULT  hr;
LONG     Index;

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