SQLBindCol

Como regra geral, considere as implicações do uso do SQLBindCol para causar a conversão de dados. Conversões de associação são processos de cliente, portanto, a recuperação de um valor de ponto flutuante associado a uma coluna de caractere faz com que o driver execute a conversão float-to-character 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 resultados em uma única execução de instrução. Cada conjunto de resultados deve ser associado separadamente. Para obter mais informações sobre a associação para vários conjuntos de resultados, consulte SQLMoreResults.

O desenvolvedor pode associar colunas a tipos de dados C específicos do SQL Server usando o valor SQL_C_BINARYTargetType. 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 biblioteca de banco de dados e DB-Library os desenvolvedores que portam 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 truncamento garantindo que todos os buffers de dados associados sejam largos o suficiente para retornar dados. Para dados de caractere, a largura deve incluir espaço para um terminador de cadeia de caracteres quando o comportamento de driver padrão para terminação de cadeia de caracteres é usado. Por exemplo, associar uma coluna char(5) do SQL Server a uma matriz de cinco caracteres resulta em truncamento para cada valor buscado. Associar a mesma coluna a uma matriz de seis caracteres evita o truncamento fornecendo um elemento de caractere no qual armazenar o terminador nulo. O SQLGetData pode ser usado para recuperar com eficiência dados binários e de caracteres longos sem truncamento.

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

Suporte do SQLBindCol para recursos avançados de data e hora

Os valores de coluna de resultado de tipos de data/hora são convertidos conforme descrito em Conversões de SQL para C. Observe que para recuperar as colunas time e datetimeoffset 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 Melhorias de data e hora (ODBC).

Suporte do SQLBindCol para UDTs CLR grandes

O SQLBindCol dá suporte a grandes UDTs (tipos definidos pelo usuário) CLR. Para obter mais informações, consulte ODBC (Tipos Definidos pelo Usuário) CLR Grandes.

Consulte Também

de função SQLBindCol
Detalhes da implementação da API do ODBC