Compartir a través de


SQLGetDescField y SQLGetDescRec (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 las funciones SQLGetDescField y SQLGetDescRec en la biblioteca de cursores. Para obtener información general sobre estas funciones, vea Función SQLGetDescField y Función SQLGetDescRec.

La biblioteca de cursores ejecuta SQLGetDescRec para devolver metadatos para las columnas de marcador. La biblioteca de cursores ejecuta SQLGetDescField para devolver los mismos campos devueltos por SQLGetDescRec, que son SQL_DESC_NAME, SQL_DESC_TYPE, SQL_DESC_DATETIME_INTERVAL_CODE, SQL_DESC_OCTET_LENGTH, SQL_DESC_PRECISION, SQL_DESC_SCALE y SQL_DESC_NULLABLE. Para la coherencia, SQLGetDescField también devuelve SQL_DESC_UNNAMED.

La biblioteca de cursores ejecuta SQLGetDescField cuando se llama para devolver el valor de los campos siguientes que se establecen para las columnas de marcador de enlace: SQL_DESC_DATA_PTR, SQL_DESC_INDICATOR_PTR, SQL_DESC_OCTET_LENGTH_PTR y SQL_DESC_LENGTH.

La biblioteca de cursores ejecuta SQLGetDescField cuando se llama para devolver el valor del campo SQL_DESC_BIND_OFFSET_PTR, SQL_DESC_BIND_TYPE, SQL_DESC_ROW_ARRAY_SIZE o SQL_DESC_ROW_STATUS_PTR. Estos campos se pueden devolver para cualquier fila, no solo para la fila de marcador.

Si una aplicación llama a SQLGetDescField para devolver el valor de cualquier campo que no sea el mencionado anteriormente, la biblioteca de cursores pasa la llamada al controlador.