Método IEnumCERTVIEWCOLUMN::GetName (certview.h)
O método GetName recupera o nome não localizado da coluna atual na sequência de enumeração de coluna.
Sintaxe
HRESULT GetName(
[out] BSTR *pstrOut
);
Parâmetros
[out] pstrOut
Um ponteiro para uma variável do tipo BSTR que contém o nome da coluna.
Retornar valor
C++
Se o método for bem-sucedido, o método retornará S_OK e o parâmetro pstrOut conterá o nome 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 da coluna.Comentários
Esse método é usado para recuperar o nome nãocalizado 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, GetName 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 bstrColName = NULL;
HRESULT hr;
// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
printf("Column name is %ws\n", bstrColName);
// done processing, clear resources
if (NULL != bstrColName)
SysFreeString(bstrColName);
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 |