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

Artigo
02/28/2024

O método EnumCertViewAttribute obtém uma instância de uma sequência de enumeração de atributo para a linha atual da sequência de enumeração de linha.

Sintaxe

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

Parâmetros

[in] Flags

C++	Um valor LONG . Deve ser zero.
VB	Um valor Long . Deve ser zero.

[out] ppenum

Um ponteiro para um ponteiro do tipo IEnumCERTVIEWATTRIBUTE . Após a conclusão bem-sucedida desse método, ppenum é definido como um ponteiro do tipo IEnumCERTVIEWATTRIBUTE .

Retornar valor

C++

Se o método for bem-sucedido, o método retornará S_OK.

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 é um objeto de sequência de enumeração de atributo.

Comentários

A sequência attribute-enumeration obtida por essa chamada pode ser usada para enumerar os atributos associados ao certificado na linha atual. Essa enumeração pode ser acessada por meio dos métodos da interface IEnumCERTVIEWATTRIBUTE .

Para fazer referência a uma linha diferente, chame um dos seguintes métodos para navegar pela sequência de enumeração de linha:

IEnumCERTVIEWROW::Reset: move para o início da sequência de enumeração.
IEnumCERTVIEWROW::Next: move para a próxima linha na sequência de enumeração.
IEnumCERTVIEWROW::Skip: ignora um número especificado de linhas.

Exemplos

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

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