Compartilhar via


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

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:

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

Confira também

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW

IEnumCERTVIEWROW::Next

IEnumCERTVIEWROW::Reset

IEnumCERTVIEWROW::Skip