SQLBindCol

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Como regra geral, considere as implicações de usar SQLBindCol para causar conversão de dados. As conversões de associações são processos do cliente, portanto, por exemplo, recuperar um valor de ponto flutuante associado a uma coluna de caracteres faz com que o driver execute a conversão flutuante para caractere localmente quando uma linha é buscada. A função Transact-SQL CONVERT pode ser usada para colocar o custo da conversão de dados no servidor.

Uma instância do SQL Server pode retornar vários conjuntos de linhas de resultado em uma única execução de instrução. Cada conjunto de resultados deve ser associado separadamente. Para obter mais informações sobre como associar vários conjuntos de resultados, consulte SQLMoreResults.

O desenvolvedor pode vincular colunas a tipos de dados C específicos do SQL Server usando o valor TargetType SQL_C_BINARY. As colunas associadas a tipos específicos do SQL Server não são portáteis. Os tipos de dados ODBC C específicos do SQL Server definidos correspondem às definições de tipo para DB-Library, e os desenvolvedores de DB-Library portando aplicativos podem querer aproveitar esse recurso.

O truncamento de dados de relatório é um processo caro para o driver ODBC do SQL Server Native Client. Você pode evitar o truncamento assegurando que todos os buffers de dados associados tenham largura suficiente para retornar dados. Para dados de caracteres, a largura deve incluir espaço para um terminador da cadeia de caracteres quando o comportamento padrão do driver para a terminação da cadeia de caracteres for usado. Por exemplo, vincular uma coluna char(5) do SQL Server a uma matriz de cinco caracteres resulta em truncamento para cada valor obtido. A associação da mesma coluna a uma matriz de seis caracteres evita a truncagem, fornecendo um elemento de caractere no qual armazenar o terminador nulo. SQLGetData pode ser usado para recuperar com eficiência dados de caracteres longos e dados binários sem truncagem.

Para tipos de dados de valor grande, se o buffer fornecido pelo usuário não for grande o suficiente para conter o valor inteiro da coluna, SQL_SUCCESS_WITH_INFO será retornado e os "dados de cadeia de caracteres; truncamento direito" é emitido. O argumento StrLen_or_IndPtr conterá o número de chars/bytes armazenados no buffer.

Suporte de SQLBindCol a recursos aprimorados de data e hora

Os valores da coluna de resultado dos tipos de data/hora são convertidos conforme descrito em Conversões de SQL para C. Observe que, para recuperar colunas de deslocamento de data e hora como suas estruturas correspondentes (SQL_SS_TIME2_STRUCT e SQL_SS_TIMESTAMPOFFSET_STRUCT), TargetType deve ser especificado como SQL_C_DEFAULT ou SQL_C_BINARY.

Para obter mais informações, consulte Aprimoramentos de data e hora (ODBC).

Suporte de SQLBindCol para CLR UDTs grandes

SQLBindCol dá suporte a tipos de dados CLR definidos pelo usuário. Para obter mais informações, consulte Tipos definidos pelo usuário (ODBC) CLR grandes.

Confira também

Função SQLBindCol
Detalhes da implementação da API do ODBC