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

  • Artigo

O método Next move para a próxima linha na sequência de enumeração de linha.

Sintaxe

HRESULT Next(
  [out] LONG *pIndex
);

Parâmetros

[out] pIndex

Um ponteiro para uma variável que contém o valor de índice da próxima linha que está sendo referenciada. Se não houver mais linhas para enumerar, essa variável será definida como –1. Esse método falhará se pIndex for NULL.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e a próxima linha será referenciada pela sequência de enumeração de linha. Se não houver mais linhas para enumerar, S_FALSE será retornado e pIndex será definido como um valor de –1.

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.

VB

O valor retornado é o valor de índice da linha que agora está sendo referenciada pela sequência de enumeração de linha. Se não houver mais linhas para enumerar, o valor retornado será –1.

Comentários

Após a conclusão bem-sucedida desse método, as colunas, os atributos e as extensões associados ao certificado na linha podem ser enumerados usando os métodos das seguintes interfaces:

O loop de todas as linhas na sequência de enumeração pode fazer uso intensivo de recursos para computação, dependendo da consulta envolvida e do tamanho da sequência.

Exemplos

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

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

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW