AdsGetFieldName
Retorna o nome de um campo pelo seu índice.
Sintaxe
UNSIGNED32 AdsGetFieldName(ADSHANDLE hTable, UNSIGNED16 usFieldNum,
UNSIGNED8* pucBuf, UNSIGNED16* pusLen);
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
hTable |
ADSHANDLE |
Handle da tabela. |
usFieldNum |
UNSIGNED16 |
Índice do campo (1-based). |
pucBuf |
UNSIGNED8* |
Buffer para receber o nome do campo. |
pusLen |
UNSIGNED16* |
Ponteiro para o tamanho do buffer. Na saída, contém o comprimento do nome. |
Valor de Retorno
AE_SUCCESS (0) em caso de sucesso. AE_COLUMN_NOT_FOUND (6125) se o índice do campo for inválido.
Descrição
AdsGetFieldName retorna o nome de um campo especificado pelo seu índice. O índice é baseado em 1 (o primeiro campo tem índice 1).
Para tabelas remotas, a descrição da tabela é cacheada após a primeira chamada.
Exemplo
UNSIGNED8 szName[128];
UNSIGNED16 usLen = sizeof(szName);
AdsGetFieldName(hTable, 1, szName, &usLen);
// szName contém o nome do primeiro campo