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

Artigo
02/23/2024

O método Next passa para o próximo atributo na sequência attribute-enumeration.

Sintaxe

HRESULT Next(
  [out] LONG *pIndex
);

Parâmetros

[out] pIndex

Um ponteiro para uma variável que contém o valor de índice do próximo atributo que está sendo referenciado. Se não houver mais atributos 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 o próximo atributo será referenciado pela sequência attribute-enumeration. Se não houver mais atributos, o método retornará S_FALSE 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 do atributo que agora é referenciado pela sequência attribute-enumeration. Se não houver mais atributos para enumerar, o valor retornado será –1.

Comentários

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

Exemplos

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

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