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:
- 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 |