SQLBindCol (biblioteca de cursores)

Importante

Esta característica se quitará en una versión futura de Windows. Evite usar esta característica en el nuevo trabajo de desarrollo y planee modificar las aplicaciones que actualmente usan esta característica. Microsoft recomienda usar la funcionalidad del cursor del controlador.

En este tema se describe el uso de la función SQLBindCol en la biblioteca de cursores. Para obtener información general sobre SQLBindCol, vea Función SQLBindCol.

Una aplicación asigna uno o varios búferes para que la biblioteca de cursores devuelva el conjunto de filas actual. Llama a SQLBindCol una o varias veces para enlazar estos búferes al conjunto de resultados.

Una aplicación puede llamar a SQLBindCol para volver a enlazar columnas del conjunto de resultados después de llamar a SQLExtendedFetch, SQLFetch o SQLFetchScroll, siempre que el tipo de datos C, el tamaño de columna y los dígitos decimales de la columna enlazada permanezcan iguales. La aplicación no necesita cerrar el cursor para volver a enlazar columnas a diferentes direcciones.

La biblioteca de cursores admite la configuración del atributo de instrucción SQL_ATTR_ROW_BIND_OFFSET_PTR para usar desplazamientos de enlace. (No es necesario llamar a SQLBindCol para que se produzca esta reenlazamiento). Si la biblioteca de cursores se usa con un controlador ODBC 3.x , el desplazamiento de enlace no se usa cuando se llama a SQLFetch . El desplazamiento de enlace se usa si se llama a SQLFetch cuando se usa la biblioteca de cursores con un controlador ODBC 2.x porque SQLFetch se asigna a SQLExtendedFetch.

La biblioteca de cursores admite la llamada a SQLBindCol para enlazar la columna de marcador.

Cuando se trabaja con un controlador ODBC 2.x , la biblioteca de cursores devuelve SQLSTATE HY090 (longitud de cadena o búfer no válida) cuando se llama a SQLBindCol para establecer la longitud del búfer de una columna de marcador en un valor no igual a 4. Cuando se trabaja con un controlador ODBC 3.x , la biblioteca de cursores permite que el búfer tenga cualquier tamaño.