Método ICertServerPolicy::EnumerateAttributes (certif.h)

O método EnumerateAttributes recupera o nome do atributo atual e move o ponteiro de enumeração interno para o próximo atributo.

Sintaxe

HRESULT EnumerateAttributes(
  [out] BSTR *pstrAttributeName
);

Parâmetros

[out] pstrAttributeName

Um ponteiro para o nome do atributo.

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pstrAttributeName será definido como um BSTR que contém o nome do atributo. Um valor de S_FALSE será retornado se o último atributo já tiver sido enumerado.

Para usar esse método, crie uma variável do tipo BSTR , defina a variável igual a NULL e passe o endereço dessa variável como pstrAttributeName.

Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .

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

Retorna uma cadeia de caracteres que contém o nome do atributo ou uma cadeia de caracteres vazia se o último atributo já tiver sido enumerado.

Comentários

Antes de chamar o método EnumerateAttributes pela primeira vez, chame o método EnumerateAttributesSetup para inicializar o ponteiro de enumeração para o primeiro atributo.

Quando terminar de enumerar, chame
o método EnumerateAttributesClose para liberar recursos usados pelas chamadas de enumeração.

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	certif.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certcli.dll

Confira também

ICertServerPolicy

ICertServerPolicy::EnumerateAttributesClose

ICertServerPolicy::EnumerateAttributesSetup