Método IEnumCERTVIEWATTRIBUTE::GetName (certview.h)
O método GetName recupera o nome do atributo atual na sequência attribute-enumeration.
Sintaxe
HRESULT GetName(
[out] BSTR *pstrOut
);
Parâmetros
[out] pstrOut
Um ponteiro para uma variável do tipo BSTR que contém o nome do atributo.
Retornar valor
C++
Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pstrOut conterá o nome do atributo.Para usar esse método, crie uma variável do tipo BSTR , defina a variável igual a NULL e passe o endereço dessa variável como pstrOut. Quando terminar de usar o BSTR, libere-o chamando a função SysFreeString .
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 String que contém o nome do atributo.Comentários
Esse método é usado para recuperar o nome do atributo atualmente referenciado pela sequência attribute-enumeration.
Se a sequência attribute-enumeration não estiver referenciando um atributo válido, GetName falhará. Use um dos seguintes métodos para navegar pela enumeração:
- IEnumCERTVIEWATTRIBUTE::Reset: move para o início da sequência de enumeração.
- IEnumCERTVIEWATTRIBUTE::Next: move para o próximo atributo na sequência de enumeração.
- IEnumCERTVIEWATTRIBUTE::Skip: ignora um número especificado de atributos.
Exemplos
BSTR bstrAttribName = NULL;
// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
hr = pEnumAttr->GetName(&bstrAttribName);
if (S_OK != hr)
printf("Failed call to GetName - %x\n", hr);
else
printf("Attribute name is %ws\n", bstrAttribName );
// free memory when done
if (NULL != bstrAttribName)
SysFreeString(bstrAttribName);
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 |