Função SQLColumns
Conformidade
Versão introduzida: ODBC 1.0 Standards Compliance: Open Group
Resumo
SQLColumns retorna a lista de nomes de coluna em tabelas especificadas. O driver retorna essas informações como um conjunto de resultados no StatementHandle especificado.
Sintaxe
SQLRETURN SQLColumns(
SQLHSTMT StatementHandle,
SQLCHAR * CatalogName,
SQLSMALLINT NameLength1,
SQLCHAR * SchemaName,
SQLSMALLINT NameLength2,
SQLCHAR * TableName,
SQLSMALLINT NameLength3,
SQLCHAR * ColumnName,
SQLSMALLINT NameLength4);
Argumentos
StatementHandle
[Entrada] Identificador de instrução.
Catalogname
[Entrada] Nome do catálogo. Se um driver der suporte a catálogos para algumas tabelas, mas não para outras, como quando o driver recupera dados de DBMSs diferentes, uma cadeia de caracteres vazia ("") indica as tabelas que não têm catálogos. CatalogName não pode conter um padrão de pesquisa de cadeia de caracteres.
Observação
Se o atributo de instrução SQL_ATTR_METADATA_ID estiver definido como SQL_TRUE, CatalogName será tratado como um identificador e seu caso não será significativo. Se for SQL_FALSE, CatalogName será um argumento comum; é tratado literalmente, e seu caso é significativo. Para obter mais informações, consulte Argumentos em funções de catálogo.
NameLength1
[Entrada] Comprimento em caracteres de *CatalogName.
Schemaname
[Entrada] Padrão de pesquisa de cadeia de caracteres para nomes de esquema. Se um driver der suporte a esquemas para algumas tabelas, mas não para outras, como quando o driver recupera dados de DBMSs diferentes, uma cadeia de caracteres vazia ("") indica as tabelas que não têm esquemas.
Observação
Se o atributo de instrução SQL_ATTR_METADATA_ID estiver definido como SQL_TRUE, SchemaName será tratado como um identificador e seu caso não será significativo. Se for SQL_FALSE, SchemaName será um argumento de valor padrão; é tratado literalmente, e seu caso é significativo.
NameLength2
[Entrada] Comprimento em caracteres de *SchemaName.
TableName
[Entrada] Padrão de pesquisa de cadeia de caracteres para nomes de tabela.
Observação
Se o atributo de instrução SQL_ATTR_METADATA_ID estiver definido como SQL_TRUE, TableName será tratado como um identificador e seu caso não será significativo. Se for SQL_FALSE, TableName será um argumento de valor padrão; é tratado literalmente, e seu caso é significativo.
NameLength3
[Entrada] Comprimento em caracteres de *TableName.
ColumnName
[Entrada] Padrão de pesquisa de cadeia de caracteres para nomes de coluna.
Observação
Se o atributo de instrução SQL_ATTR_METADATA_ID estiver definido como SQL_TRUE, ColumnName será tratado como um identificador e seu caso não será significativo. Se for SQL_FALSE, ColumnName será um argumento de valor padrão; é tratado literalmente, e seu caso é significativo.
NameLength4
[Entrada] Comprimento em caracteres de *ColumnName.
Retornos
SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_STILL_EXECUTING, SQL_ERROR ou SQL_INVALID_HANDLE.
Diagnósticos
Quando SQLColumns retorna SQL_ERROR ou SQL_SUCCESS_WITH_INFO, um valor SQLSTATE associado pode ser obtido chamando SQLGetDiagRec com um HandleType de SQL_HANDLE_STMT e um Identificador de StatementHandle. A tabela a seguir lista os valores SQLSTATE normalmente retornados por SQLColumns e explica cada um deles no contexto dessa função; a notação "(DM)" precede as descrições de SQLSTATEs retornadas pelo Gerenciador de Driver. O código de retorno associado a cada valor SQLSTATE é SQL_ERROR, a menos que indicado de outra forma.
| SQLSTATE | Erro | Descrição |
|---|---|---|
| 01000 | Aviso geral | Mensagem informativa específica do driver. (A função retorna SQL_SUCCESS_WITH_INFO.) |
| 08S01 | Falha no link de comunicação | O link de comunicação entre o driver e a fonte de dados à qual o driver foi conectado falhou antes da conclusão do processamento da função. |
| 24.000 | Estado de cursor inválido | Um cursor foi aberto no StatementHandle e SQLFetch ou SQLFetchScroll foram chamados. Esse erro será retornado pelo Gerenciador de Driver se SQLFetch ou SQLFetchScroll não tiver retornado SQL_NO_DATA e for retornado pelo driver se SQLFetch ou SQLFetchScroll tiver retornado SQL_NO_DATA. Um cursor foi aberto no StatementHandle , mas SQLFetch ou SQLFetchScroll não foram chamados. |
| 40001 | Falha na serialização | A transação foi revertida devido a um deadlock de recursos com outra transação. |
| 40003 | Conclusão da instrução desconhecida | Falha na conexão associada durante a execução dessa função e o estado da transação não pode ser determinado. |
| HY000 | Erro geral | Ocorreu um erro para o qual não havia nenhum SQLSTATE específico e para o qual nenhum SQLSTATE específico da implementação foi definido. A mensagem de erro retornada por SQLGetDiagRec no buffer *MessageText descreve o erro e sua causa. |
| HY001 | Erro de alocação de memória | O driver não pôde alocar memória necessária para dar suporte à execução ou à conclusão da função. |
| HY008 | Operação cancelada | O processamento assíncrono foi habilitado para o StatementHandle. A função foi chamada e, antes de concluir a execução, SQLCancel ou SQLCancelHandle foi chamado no StatementHandle. Em seguida, a função foi chamada novamente no StatementHandle. A função foi chamada e, antes de concluir a execução, SQLCancel ou SQLCancelHandle foi chamado no StatementHandle de um thread diferente em um aplicativo multithread. |
| HY009 | Uso inválido de ponteiro nulo | O atributo de instrução SQL_ATTR_METADATA_ID foi definido como SQL_TRUE, o argumento CatalogName era um ponteiro nulo e o SQL_CATALOG_NAME InfoType retorna que há suporte para nomes de catálogo. (DM) O atributo de instrução SQL_ATTR_METADATA_ID foi definido como SQL_TRUE e o argumento SchemaName, TableName ou ColumnName era um ponteiro nulo. |
| HY010 | Erro de sequência de funções | (DM) Uma função de execução assíncrona foi chamada para o identificador de conexão associado ao StatementHandle. Essa função assíncrona ainda estava em execução quando a função SQLColumns foi chamada. (DM) SQLExecute, SQLExecDirect ou SQLMoreResults foi chamado para o StatementHandle e retornou SQL_PARAM_DATA_AVAILABLE. Essa função foi chamada antes de os dados serem recuperados para todos os parâmetros transmitidos. (DM) Uma função de execução assíncrona (não esta) foi chamada para o StatementHandle e ainda estava em execução quando essa função foi chamada. (DM) SQLExecute, SQLExecDirect, SQLBulkOperations ou SQLSetPos foram chamados para o StatementHandle e retornaram SQL_NEED_DATA. Essa função foi chamada antes de os dados serem enviados para todos os parâmetros ou colunas de dados em execução. |
| HY013 | Erro de gerenciamento de memória | A chamada de função não pôde ser processada porque os objetos de memória subjacentes não puderam ser acessados, possivelmente devido a condições de memória baixa. |
| HY090 | Comprimento de buffer ou cadeia de caracteres inválido | (DM) O valor de um dos argumentos de comprimento de nome era menor que 0, mas não igual a SQL_NTS. |
| O valor de um dos argumentos de comprimento de nome excedeu o valor de comprimento máximo para o catálogo ou nome correspondente. O comprimento máximo de cada catálogo ou nome pode ser obtido chamando SQLGetInfo com os valores de InfoType . (Confira "Comentários".) | ||
| HY117 | A conexão está suspensa devido ao estado de transação desconhecido. Somente funções desconectar e somente leitura são permitidas. | (DM) Para obter mais informações sobre o estado suspenso, consulte Função SQLEndTran. |
| HYC00 | Recurso opcional não implementado | Um nome de catálogo foi especificado e o driver ou fonte de dados não dá suporte a catálogos. Um nome de esquema foi especificado e o driver ou fonte de dados não dá suporte a esquemas. Um padrão de pesquisa de cadeia de caracteres foi especificado para o nome do esquema, nome da tabela ou nome da coluna e a fonte de dados não dá suporte a padrões de pesquisa para um ou mais desses argumentos. A combinação das configurações atuais dos atributos de instrução SQL_ATTR_CONCURRENCY e SQL_ATTR_CURSOR_TYPE não era compatível com o driver ou a fonte de dados. O atributo de instrução SQL_ATTR_USE_BOOKMARKS foi definido como SQL_UB_VARIABLE e o atributo de instrução SQL_ATTR_CURSOR_TYPE foi definido como um tipo de cursor para o qual o driver não dá suporte a indicadores. |
| HYT00 | Tempo limite esgotado | O período de tempo limite da consulta expirou antes da fonte de dados retornar o conjunto de resultados. O período de tempo limite é definido por meio de SQLSetStmtAttr, SQL_ATTR_QUERY_TIMEOUT. |
| HYT01 | O tempo limite da conexão expirou | O período de tempo limite da conexão expirou antes da fonte de dados responder à solicitação. O período de tempo limite da conexão é definido por meio de SQLSetConnectAttr, SQL_ATTR_CONNECTION_TIMEOUT. |
| IM001 | O driver não dá suporte a essa função | (DM) O driver associado ao StatementHandle não dá suporte à função . |
| IM017 | A sondagem está desabilitada no modo de notificação assíncrona | Sempre que o modelo de notificação é usado, a sondagem é desabilitada. |
| IM018 | SQLCompleteAsync não foi chamado para concluir a operação assíncrona anterior nesse identificador. | Se a chamada de função anterior no identificador retornar SQL_STILL_EXECUTING e se o modo de notificação estiver habilitado, SQLCompleteAsync deverá ser chamado no identificador para fazer o pós-processamento e concluir a operação. |
Comentários
Normalmente, essa função é usada antes da execução da instrução para recuperar informações sobre colunas para uma tabela ou tabelas do catálogo da fonte de dados. SQLColumns pode ser usado para recuperar dados para todos os tipos de itens retornados por SQLTables. Além das tabelas base, isso pode incluir (mas não se limita a) exibições, sinônimos, tabelas do sistema e assim por diante. Por outro lado, as funções SQLColAttribute e SQLDescribeCol descrevem as colunas em um conjunto de resultados e a função SQLNumResultCols retorna o número de colunas em um conjunto de resultados. Para obter mais informações, consulte Usos de dados de catálogo.
Observação
Para obter mais informações sobre o uso geral, argumentos e dados retornados de funções de catálogo ODBC, consulte Funções de catálogo.
SQLColumns retorna os resultados como um conjunto de resultados padrão, ordenado por TABLE_CAT, TABLE_SCHEM, TABLE_NAME e ORDINAL_POSITION.
Observação
Quando um aplicativo funciona com um ODBC 2. x driver, nenhuma coluna ORDINAL_POSITION é retornada no conjunto de resultados. Como resultado, ao trabalhar com o ODBC 2. x drivers, a ordem das colunas na lista de colunas retornada por SQLColumns não é necessariamente a mesma que a ordem das colunas retornadas quando o aplicativo executa uma instrução SELECT em todas as colunas nessa tabela.
Observação
SQLColumns pode não retornar todas as colunas. Por exemplo, um driver pode não retornar informações sobre pseudo-colunas, como Oracle ROWID. Os aplicativos podem usar qualquer coluna válida, seja ela retornada por SQLColumns.
Algumas colunas que podem ser retornadas por SQLStatistics não são retornadas por SQLColumns. Por exemplo, SQLColumns não retorna as colunas em um índice criado em uma expressão ou filtro, como SALARY + BENEFITS ou DEPT = 0012.
Os comprimentos das colunas VARCHAR não são mostrados na tabela; os comprimentos reais dependem da fonte de dados. Para determinar os comprimentos reais das colunas TABLE_CAT, TABLE_SCHEM, TABLE_NAME e COLUMN_NAME, um aplicativo pode chamar SQLGetInfo com as opções SQL_MAX_CATALOG_NAME_LEN, SQL_MAX_SCHEMA_NAME_LEN, SQL_MAX_TABLE_NAME_LEN e SQL_MAX_COLUMN_NAME_LEN.
As colunas a seguir foram renomeada para ODBC 3. x. As alterações de nome de coluna não afetam a compatibilidade com versões anteriores porque os aplicativos são associados por número de coluna.
| Coluna ODBC 2.0 | ODBC 3. coluna x |
|---|---|
| TABLE_QUALIFIER | TABLE_CAT |
| TABLE_OWNER | TABLE_SCHEM |
| PRECISION | COLUMN_SIZE |
| LENGTH | BUFFER_LENGTH |
| SCALE | DECIMAL_DIGITS |
| RADIX | NUM_PREC_RADIX |
As colunas a seguir foram adicionadas ao conjunto de resultados retornado por SQLColumns para ODBC 3. x:
CHAR_OCTET_LENGTH
COLUMN_DEF
IS_NULLABLE
ORDINAL_POSITION
SQL_DATA_TYPE
SQL_DATETIME_SUB
A tabela a seguir lista as colunas no conjunto de resultados. Colunas adicionais além da coluna 18 (IS_NULLABLE) podem ser definidas pelo driver. Um aplicativo deve obter acesso a colunas específicas do driver contando a partir do final do conjunto de resultados em vez de especificar uma posição ordinal explícita. Para obter mais informações, consulte Dados retornados por funções de catálogo.
| Nome da coluna | Coluna número |
Tipo de dados | Comentários |
|---|---|---|---|
| TABLE_CAT (ODBC 1.0) | 1 | Varchar | Nome do catálogo; NULL se não for aplicável à fonte de dados. Se um driver der suporte a catálogos para algumas tabelas, mas não para outras, como quando o driver recupera dados de DBMSs diferentes, ele retorna uma cadeia de caracteres vazia ("") para as tabelas que não têm catálogos. |
| TABLE_SCHEM (ODBC 1.0) | 2 | Varchar | Nome do esquema; NULL se não for aplicável à fonte de dados. Se um driver der suporte a esquemas para algumas tabelas, mas não para outras, como quando o driver recupera dados de DBMSs diferentes, ele retorna uma cadeia de caracteres vazia ("") para as tabelas que não têm esquemas. |
| TABLE_NAME (ODBC 1.0) | 3 | Varchar não NULL | Nome da tabela. |
| COLUMN_NAME (ODBC 1.0) | 4 | Varchar não NULL | Nome da coluna. O driver retorna uma cadeia de caracteres vazia para uma coluna que não tem um nome. |
| DATA_TYPE (ODBC 1.0) | 5 | Smallint não NULL | Tipo de dados SQL. Pode ser um tipo de dados SQL ODBC ou um tipo de dados SQL específico do driver. Para tipos de dados datetime e interval, essa coluna retorna o tipo de dados conciso (como SQL_TYPE_DATE ou SQL_INTERVAL_YEAR_TO_MONTH, em vez do tipo de dados não contíguo, como SQL_DATETIME ou SQL_INTERVAL). Para obter uma lista de tipos de dados SQL ODBC válidos, consulte Tipos de dados SQL no Apêndice D: Tipos de Dados. Para informações sobre tipos de dados SQL específicos do driver, confira a documentação do driver. Os tipos de dados retornados para ODBC 3. x e ODBC 2. x aplicativos podem ser diferentes. Para obter mais informações, consulte Compatibilidade com versões anteriores e Conformidade com padrões. |
| TYPE_NAME (ODBC 1.0) | 6 | Varchar não NULL | Nome do tipo de dados dependente da fonte de dados; por exemplo, "CHAR", "VARCHAR", "MONEY", "LONG VARBINAR" ou "CHAR ( ) FOR BIT DATA". |
| COLUMN_SIZE (ODBC 1.0) | 7 | Inteiro | Se DATA_TYPE for SQL_CHAR ou SQL_VARCHAR, essa coluna conterá o comprimento máximo em caracteres da coluna. Para tipos de dados datetime, esse é o número total de caracteres necessários para exibir o valor quando ele é convertido em caracteres. Para tipos de dados numéricos, esse é o número total de dígitos ou o número total de bits permitidos na coluna, de acordo com a coluna NUM_PREC_RADIX. Para tipos de dados de intervalo, esse é o número de caracteres na representação de caracteres do literal de intervalo (conforme definido pela precisão à esquerda do intervalo, consulte Interval Data Type Length in Appendix D: Data Types). Para obter mais informações, consulte Tamanho da Coluna, Dígitos Decimais, Tamanho do Octeto de Transferência e Tamanho de Exibição no Apêndice D: Tipos de Dados. |
| BUFFER_LENGTH (ODBC 1.0) | 8 | Inteiro | O comprimento em bytes de dados transferidos em uma operação SQLGetData, SQLFetch ou SQLFetchScroll se SQL_C_DEFAULT for especificado. Para dados numéricos, esse tamanho pode ser diferente do tamanho dos dados armazenados na fonte de dados. Esse valor pode ser diferente de COLUMN_SIZE coluna para dados de caracteres. Para obter mais informações sobre comprimento, consulte Tamanho da Coluna, Dígitos Decimais, Tamanho do Octeto de Transferência e Tamanho de Exibição no Apêndice D: Tipos de Dados. |
| DECIMAL_DIGITS (ODBC 1.0) | 9 | Smallint | O número total de dígitos significativos à direita do ponto decimal. Para SQL_TYPE_TIME e SQL_TYPE_TIMESTAMP, essa coluna contém o número de dígitos no componente de segundos fracionários. Para os outros tipos de dados, esses são os dígitos decimais da coluna na fonte de dados. Para tipos de dados de intervalo que contêm um componente de tempo, essa coluna contém o número de dígitos à direita do ponto decimal (segundos fracionários). Para tipos de dados de intervalo que não contêm um componente de tempo, essa coluna é 0. Para obter mais informações sobre dígitos decimais, consulte Tamanho da coluna, dígitos decimais, tamanho do octeto de transferência e tamanho de exibição no apêndice D: tipos de dados. NULL é retornado para tipos de dados em que DECIMAL_DIGITS não é aplicável. |
| NUM_PREC_RADIX (ODBC 1.0) | 10 | Smallint | Para tipos de dados numéricos, 10 ou 2. Se for 10, os valores em COLUMN_SIZE e DECIMAL_DIGITS fornecerão o número de dígitos decimais permitidos para a coluna. Por exemplo, uma coluna DECIMAL(12,5) retornaria um NUM_PREC_RADIX de 10, um COLUMN_SIZE de 12 e um DECIMAL_DIGITS de 5; uma coluna FLOAT pode retornar um NUM_PREC_RADIX de 10, um COLUMN_SIZE de 15 e um DECIMAL_DIGITS de NULL. Se for 2, os valores em COLUMN_SIZE e DECIMAL_DIGITS fornecerão o número de bits permitidos na coluna. Por exemplo, uma coluna FLOAT pode retornar um RADIX de 2, um COLUMN_SIZE de 53 e um DECIMAL_DIGITS de NULL. NULL é retornado para tipos de dados em que NUM_PREC_RADIX não é aplicável. |
| NULLABLE (ODBC 1.0) | 11 | Smallint não NULL | SQL_NO_NULLS se a coluna não puder incluir valores NULL. SQL_NULLABLE se a coluna aceitar valores NULL. SQL_NULLABLE_UNKNOWN se não se sabe se a coluna aceita valores NULL. O valor retornado para essa coluna difere do valor retornado para a coluna IS_NULLABLE. A coluna NULLABLE indica com certeza que uma coluna pode aceitar NULLs, mas não pode indicar com certeza que uma coluna não aceita NULLs. A coluna IS_NULLABLE indica com certeza que uma coluna não pode aceitar NULLs, mas não pode indicar com certeza que uma coluna aceita NULLs. |
| COMENTÁRIOS (ODBC 1.0) | 12 | Varchar | Uma descrição da coluna. |
| COLUMN_DEF (ODBC 3.0) | 13 | Varchar | O valor padrão da coluna. O valor nessa coluna deverá ser interpretado como uma cadeia de caracteres se estiver entre aspas. Se NULL tiver sido especificado como o valor padrão, essa coluna será a palavra NULL, não entre aspas. Se o valor padrão não puder ser representado sem truncamento, essa coluna conterá TRUNCATED, sem incluir aspas simples. Se nenhum valor padrão tiver sido especificado, essa coluna será NULL. O valor de COLUMN_DEF pode ser usado na geração de uma nova definição de coluna, exceto quando ela contém o valor TRUNCATED. |
| SQL_DATA_TYPE (ODBC 3.0) | 14 | Smallint não NULL | Tipo de dados SQL, como aparece no campo de registro SQL_DESC_TYPE no IRD. Pode ser um tipo de dados SQL ODBC ou um tipo de dados SQL específico do driver. Essa coluna é igual à coluna DATA_TYPE, exceto para tipos de dados datetime e interval. Essa coluna retorna o tipo de dados não contíguo (como SQL_DATETIME ou SQL_INTERVAL), em vez do tipo de dados conciso (como SQL_TYPE_DATE ou SQL_INTERVAL_YEAR_TO_MONTH) para tipos de dados datetime e interval. Se essa coluna retornar SQL_DATETIME ou SQL_INTERVAL, o tipo de dados específico poderá ser determinado na coluna SQL_DATETIME_SUB. Para obter uma lista de tipos de dados SQL ODBC válidos, consulte Tipos de dados SQL no Apêndice D: Tipos de Dados. Para informações sobre tipos de dados SQL específicos do driver, confira a documentação do driver. Os tipos de dados retornados para ODBC 3. x e ODBC 2. x aplicativos podem ser diferentes. Para obter mais informações, consulte Compatibilidade com versões anteriores e Conformidade com padrões. |
| SQL_DATETIME_SUB (ODBC 3.0) | 15 | Smallint | O código de subtipo para tipos de dados datetime e interval. Para outros tipos de dados, essa coluna retorna um NULL. Para obter mais informações sobre subcódigos datetime e interval, confira "SQL_DESC_DATETIME_INTERVAL_CODE" em SQLSetDescField. |
| CHAR_OCTET_LENGTH (ODBC 3.0) | 16 | Inteiro | O comprimento máximo em bytes de uma coluna de tipo de dados binário ou caractere. Para todos os outros tipos de dados, essa coluna retorna um NULL. |
| ORDINAL_POSITION (ODBC 3.0) | 17 | Integer não NULL | A posição ordinal da coluna na tabela. A primeira coluna na tabela é o número 1. |
| IS_NULLABLE (ODBC 3.0) | 18 | Varchar | "NÃO" se a coluna não incluir NULLs. "SIM" se a coluna puder incluir NULLs. Esta coluna retorna uma cadeia de caracteres de comprimento zero se a possibilidade de nulidade for desconhecida. As regras ISO são seguidas para determinar a possibilidade de nulidade. Um DBMS em conformidade com ISO SQL não pode retornar uma cadeia de caracteres vazia. O valor retornado para essa coluna difere do valor retornado para a coluna NULLABLE. (Consulte a descrição da coluna NULLABLE.) |
Exemplo de código
No exemplo a seguir, um aplicativo declara buffers para o conjunto de resultados retornado por SQLColumns. Ele chama SQLColumns para retornar um conjunto de resultados que descreve cada coluna na tabela EMPLOYEE. Em seguida, ele chama SQLBindCol para associar as colunas no conjunto de resultados aos buffers. Por fim, o aplicativo busca cada linha de dados com SQLFetch e os processa.
// SQLColumns_Function.cpp
// compile with: ODBC32.lib
#include <windows.h>
#include <sqlext.h>
#define STR_LEN 128 + 1
#define REM_LEN 254 + 1
// Declare buffers for result set data
SQLCHAR szSchema[STR_LEN];
SQLCHAR szCatalog[STR_LEN];
SQLCHAR szColumnName[STR_LEN];
SQLCHAR szTableName[STR_LEN];
SQLCHAR szTypeName[STR_LEN];
SQLCHAR szRemarks[REM_LEN];
SQLCHAR szColumnDefault[STR_LEN];
SQLCHAR szIsNullable[STR_LEN];
SQLINTEGER ColumnSize;
SQLINTEGER BufferLength;
SQLINTEGER CharOctetLength;
SQLINTEGER OrdinalPosition;
SQLSMALLINT DataType;
SQLSMALLINT DecimalDigits;
SQLSMALLINT NumPrecRadix;
SQLSMALLINT Nullable;
SQLSMALLINT SQLDataType;
SQLSMALLINT DatetimeSubtypeCode;
SQLHSTMT hstmt = NULL;
// Declare buffers for bytes available to return
SQLINTEGER cbCatalog;
SQLINTEGER cbSchema;
SQLINTEGER cbTableName;
SQLINTEGER cbColumnName;
SQLINTEGER cbDataType;
SQLINTEGER cbTypeName;
SQLINTEGER cbColumnSize;
SQLLEN cbBufferLength;
SQLINTEGER cbDecimalDigits;
SQLINTEGER cbNumPrecRadix;
SQLINTEGER cbNullable;
SQLINTEGER cbRemarks;
SQLINTEGER cbColumnDefault;
SQLINTEGER cbSQLDataType;
SQLINTEGER cbDatetimeSubtypeCode;
SQLINTEGER cbCharOctetLength;
SQLINTEGER cbOrdinalPosition;
SQLINTEGER cbIsNullable;
int main() {
SQLHENV henv;
SQLHDBC hdbc;
SQLHSTMT hstmt = 0;
SQLRETURN retcode;
retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);
retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);
retcode = SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);
retcode = SQLConnect(hdbc, (SQLCHAR*) "Northwind", SQL_NTS, (SQLCHAR*) NULL, 0, NULL, 0);
retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);
retcode = SQLColumns(hstmt, NULL, 0, NULL, 0, (SQLCHAR*)"CUSTOMERS", SQL_NTS, NULL, 0);
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {
// Bind columns in result set to buffers
SQLBindCol(hstmt, 1, SQL_C_CHAR, szCatalog, STR_LEN,&cbCatalog);
SQLBindCol(hstmt, 2, SQL_C_CHAR, szSchema, STR_LEN, &cbSchema);
SQLBindCol(hstmt, 3, SQL_C_CHAR, szTableName, STR_LEN,&cbTableName);
SQLBindCol(hstmt, 4, SQL_C_CHAR, szColumnName, STR_LEN, &cbColumnName);
SQLBindCol(hstmt, 5, SQL_C_SSHORT, &DataType, 0, &cbDataType);
SQLBindCol(hstmt, 6, SQL_C_CHAR, szTypeName, STR_LEN, &cbTypeName);
SQLBindCol(hstmt, 7, SQL_C_SLONG, &ColumnSize, 0, &cbColumnSize);
SQLBindCol(hstmt, 8, SQL_C_SLONG, &BufferLength, 0, &cbBufferLength);
SQLBindCol(hstmt, 9, SQL_C_SSHORT, &DecimalDigits, 0, &cbDecimalDigits);
SQLBindCol(hstmt, 10, SQL_C_SSHORT, &NumPrecRadix, 0, &cbNumPrecRadix);
SQLBindCol(hstmt, 11, SQL_C_SSHORT, &Nullable, 0, &cbNullable);
SQLBindCol(hstmt, 12, SQL_C_CHAR, szRemarks, REM_LEN, &cbRemarks);
SQLBindCol(hstmt, 13, SQL_C_CHAR, szColumnDefault, STR_LEN, &cbColumnDefault);
SQLBindCol(hstmt, 14, SQL_C_SSHORT, &SQLDataType, 0, &cbSQLDataType);
SQLBindCol(hstmt, 15, SQL_C_SSHORT, &DatetimeSubtypeCode, 0, &cbDatetimeSubtypeCode);
SQLBindCol(hstmt, 16, SQL_C_SLONG, &CharOctetLength, 0, &cbCharOctetLength);
SQLBindCol(hstmt, 17, SQL_C_SLONG, &OrdinalPosition, 0, &cbOrdinalPosition);
SQLBindCol(hstmt, 18, SQL_C_CHAR, szIsNullable, STR_LEN, &cbIsNullable);
while (SQL_SUCCESS == retcode) {
retcode = SQLFetch(hstmt);
/*
if (retcode == SQL_ERROR || retcode == SQL_SUCCESS_WITH_INFO)
0; // show_error();
if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO)
0; // Process fetched data
else
break;
*/
}
}
}
Funções relacionadas
| Para obter informações sobre | Consulte |
|---|---|
| Associar um buffer a uma coluna em um conjunto de resultados | Função SQLBindCol |
| Cancelando o processamento da instrução | Função SQLCancel |
| Retornando privilégios para uma coluna ou colunas | Função SQLColumnPrivileges |
| Buscando um bloco de dados ou rolando por um conjunto de resultados | Função SQLFetchScroll |
| Buscando várias linhas de dados | Função SQLFetch |
| Retornando colunas que identificam exclusivamente uma linha ou colunas atualizadas automaticamente por uma transação | Função SQLSpecialColumns |
| Retornando estatísticas e índices de tabela | Função SQLStatistics |
| Retornando uma lista de tabelas em uma fonte de dados | Função SQLTables |
| Retornando privilégios para uma tabela ou tabelas | Função SQLTablePrivileges |
Consulte Também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de