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

Artigo
03/05/2024

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

Sintaxe

HRESULT EnumCertViewExtension(
  [in]          LONG                   Flags,
  [out, retval] IEnumCERTVIEWEXTENSION **ppenum
);

Parâmetros

[in] Flags

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

[out, retval] ppenum

Um ponteiro para um ponteiro do tipo IEnumCERTVIEWEXTENSION .

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 extensão.

Comentários

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

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.
LONG       Index;
HRESULT    hr;
IEnumCERTVIEWEXTENSION * pEnumExt = NULL;
// Obtain enumerator for extensions.
hr = pEnumRow->EnumCertViewExtension(0, &pEnumExt);
if (FAILED(hr))
{
    printf("Failed EnumCertViewExtension - %x\n", hr);
    goto error;
}
// Enumerate each extension.
while (S_OK == pEnumExt->Next(&Index))
{
    // Use this extension as needed.
}
error:

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