Compartilhar via


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

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

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 extensão que está sendo referenciada. Se não houver mais extensões para enumerar, essa variável será definida como –1. Esse método falhará se pIndex for NULL.

Valor retornado

C++

Se o método for bem-sucedido, o método retornará S_OK e a próxima extensão será referenciada. Se não houver mais extensões, S_FALSE será retornado e o parâmetro 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 extensão que agora é referenciada pela sequência de enumeração de extensão. Se não houver mais extensões para enumerar, o valor retornado será –1.

Comentários

Após a conclusão bem-sucedida desse método, o nome da extensão, os sinalizadores e o valor podem ser acessados por meio dos seguintes métodos:

Exemplos

LONG  Index;
LONG  nCount;

// determine the number of extensions
nCount = 0;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
while (S_OK == pEnumExt->Next(&Index))
{
    nCount++;
}
printf("Number of extensions is %d\n", nCount);

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

Confira também

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWEXTENSION::GetFlags

IEnumCERTVIEWEXTENSION::GetName

IEnumCERTVIEWEXTENSION::GetValue