Método IEnumCERTVIEWROW::EnumCertViewAttribute (certview.h)
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 |