Método IEnumCERTVIEWCOLUMN::GetDisplayName (certview.h)
O método GetDisplayName recupera o nome localizado da coluna atual na sequência de enumeração de coluna.
Sintaxe
HRESULT GetDisplayName(
[out] BSTR *pstrOut
);
Parâmetros
[out] pstrOut
Um ponteiro para uma variável do tipo BSTR que contém o nome localizado da coluna.
Valor retornado
C++
Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pstrOut conterá o nome localizado da coluna.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 localizado da coluna.Comentários
Esse método é usado para recuperar o nome localizado da coluna atualmente referenciada pela sequência de enumeração de coluna.
Se a sequência de enumeração de coluna não estiver fazendo referência a uma coluna válida, GetDisplayName falhará. Use um dos seguintes métodos para navegar pela enumeração :
- IEnumCERTVIEWCOLUMN::Reset: move para o início da sequência de enumeração.
- IEnumCERTVIEWCOLUMN::Next: move para a próxima coluna na sequência de enumeração.
- IEnumCERTVIEWCOLUMN::Skip: ignora um número especificado de colunas.
Exemplos
BSTR bstrDisplay = NULL;
HRESULT hr;
// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object.
hr = pEnumCol->GetDisplayName(&bstrDisplay);
if (S_OK == hr)
printf("Column name is %ws\n", bstrDisplay);
// Done processing, clear resources.
if (NULL != bstrDisplay)
SysFreeString(bstrDisplay);
Requisitos
| 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 |