Campos de descriptor

Los descriptores contienen campos de encabezado y de registro que describen completamente columnas o parámetros.

Un descriptor contiene una única copia de los siguientes campos de encabezado. Si se modifica un campo de encabezado, esto afecta a todas las columnas o parámetros.

SQL_DESC_ALLOC_TYPE
SQL_DESC_ARRAY_SIZE
SQL_DESC_ARRAY_STATUS_PTR
SQL_DESC_BIND_OFFSET_PTR

SQL_DESC_BIND_TYPE
SQL_DESC_COUNT
SQL_DESC_ROWS_PROCESSED_PTR

Un descriptor contiene cero o más registros de descriptor. Cada registro describe una columna o parámetro, según el tipo de descriptor. Cuando se vincula una nueva columna o parámetro, se agrega un nuevo registro al descriptor. Cuando se desvincula una columna o un parámetro, se elimina un registro del descriptor. Cada registro contiene una única copia de los siguientes campos:

SQL_DESC_AUTO_UNIQUE_VALUE
SQL_DESC_BASE_COLUMN_NAME
SQL_DESC_BASE_TABLE_NAME
SQL_DESC_CASE_SENSITIVE
SQL_DESC_CATALOG_NAME
SQL_DESC_CONCISE_TYPE
SQL_DESC_DATA_PTR
SQL_DESC_DATETIME_INTERVAL_CODE
SQL_DESC_DATETIME_INTERVAL_PRECISION
SQL_DESC_DISPLAY_SIZE
SQL_DESC_FIXED_PREC_SCALE
SQL_DESC_INDICATOR_PTR
SQL_DESC_LABEL
SQL_DESC_LENGTH
SQL_DESC_LITERAL_PREFIX
SQL_DESC_LITERAL_SUFFIX

SQL_DESC_LOCAL_TYPE_NAME
SQL_DESC_NAME
SQL_DESC_NULLABLE
SQL_DESC_OCTET_LENGTH
SQL_DESC_OCTET_LENGTH_PTR
SQL_DESC_PARAMETER_TYPE
SQL_DESC_PRECISION
SQL_DESC_SCALE
SQL_DESC_SCHEMA_NAME
SQL_DESC_SEARCHABLE
SQL_DESC_TABLE_NAME
SQL_DESC_TYPE
SQL_DESC_TYPE_NAME
SQL_DESC_UNNAMED
SQL_DESC_UNSIGNED
SQL_DESC_UPDATABLE

Muchos atributos de instrucción se corresponden con el campo de encabezado de un descriptor. El establecimiento de estos atributos mediante una llamada a SQLSetStmtAttr y el establecimiento del campo de encabezado del descriptor correspondiente mediante una llamada a SQLSetDescField tienen el mismo efecto. Lo mismo ocurre con SQLGetStmtAttr y SQLGetDescField, que recuperan la misma información. Llamar a las funciones de instrucción en lugar de a las funciones de descriptor tiene la ventaja de que no es necesario recuperar un identificador de descriptor.

Los siguientes campos de encabezado pueden establecerse mediante atributos de instrucción:

SQL_DESC_ARRAY_SIZE
SQL_DESC_ARRAY_STATUS_PTR
SQL_DESC_BIND_OFFSET_PTR

SQL_DESC_BIND_TYPE
SQL_DESC_ROWS_PROCESSED_PTR

Esta sección contiene los temas siguientes.