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

Artigo
02/28/2024

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

Sintaxe

HRESULT EnumCertViewColumn(
  [out] IEnumCERTVIEWCOLUMN **ppenum
);

Parâmetros

[out] ppenum

Um ponteiro para um ponteiro do tipo IEnumCERTVIEWCOLUMN .

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 coluna.

Comentários

A sequência de enumeração de coluna obtida por essa chamada pode ser usada para enumerar as colunas associadas ao certificado na linha atual. Essa enumeração pode ser acessada por meio dos métodos da interface IEnumCERTVIEWCOLUMN .

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;
IEnumCERTVIEWCOLUMN * pEnumCol = NULL;
// obtain enumerator for columns
hr = pEnumRow->EnumCertViewColumn(&pEnumCol);
if ( FAILED( hr ))
{
    printf("Failed EnumCertViewColumn - %x\n", hr );
    goto error;
}
// enumerate each column
while (S_OK == pEnumCol->Next(&Index))
{
    // Use this column as needed.
}
error:

// Free resources.
if ( NULL != pEnumCol )
    pEnumCol->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