Comprimento dos dados da coluna

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A Microsoft recomenda usar a funcionalidade de cursor do driver.

A biblioteca de cursores cria um buffer no cache para cada buffer de comprimento/indicador associado ao conjunto de resultados com SQLBindCol. Ele usa os valores nesses buffers para construir uma cláusula WHERE quando emula instruções de atualização ou exclusão posicionadas. Ele atualiza esses buffers dos buffers de conjunto de linhas quando busca dados da fonte de dados e quando executa instruções de atualização posicionadas.

Se o tipo C de um buffer de dados for SQL_C_CHAR ou SQL_C_BINARY e o valor de comprimento/indicador for SQL_NTS, o comprimento da cadeia de caracteres dos dados será colocado no buffer de comprimento/indicador.

Observação

A biblioteca de cursores não atualizará seu cache para uma coluna se *StrLen_or_IndPtr no buffer de conjunto de linhas correspondente estiver SQL_DATA_AT_EXEC ou o resultado da macro SQL_LEN_DATA_AT_EXEC.