Método IEnumCERTVIEWCOLUMN::GetDisplayName (certview.h)

Artigo
08/22/2023

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