SQLSetDescRec
En este tema se describe la funcionalidad SQLSetDescRec específica de SQL Server Native Client.
SQLSetDescRec y parámetros con valores de tabla
SQLSetDescRec se puede usar para establecer campos descriptores para parámetros con valores de tabla y columnas de parámetros con valores de tabla. Las columnas de parámetro con valores de tabla únicamente están disponibles cuando el campo de encabezado del descriptor SQL_SOPT_SS_PARAM_FOCUS está establecido en el ordinal de un registro con SQL_DESC_TYPE establecido en SQL_SS_TABLE. Para obtener más información acerca de SQL_SOPT_SS_PARAM_FOCUS, vea SQLSetStmtAttr.
En la tabla siguiente se describe la asignación entre parámetros y campos descriptor.
| Parámetro | Atributo relacionado para los tipos de parámetros no con valores de tabla, incluidas las columnas de parámetros con valores de tabla | Atributo relacionado para parámetros con valores de tabla |
|---|---|---|
| Tipo | SQL_DESC_TYPE | SQL_SS_TABLE |
| Subtipo | Omitido | Para registros de tipo SQL_DATETIME o SQL_INTERVAL, establézcalo en SQL_DESC_DATETIME_INTERVAL_CODE. |
| Longitud | SQL_DESC_OCTET_LENGTH | Longitud del nombre de tipo de parámetro con valores de tabla. Puede ser SQL_NTS si el nombre de tipo termina en NULL, o cero si no se requiere el nombre de tipo de parámetro con valores de tabla. |
| Precisión | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| Escala | SQL_DESC_SCALE | Sin usar. Este parámetro debería ser cero. |
| DataPtr | SQL_DESC_DATA_PTR en APD | SQL_CA_SS_TYPE_NAME Este parámetro es opcional para las llamadas a procedimientos almacenados y puede especificarse NULL si no se requiere. Este parámetro se debe especificar en instrucciones SQL que no son llamadas a procedimientos. DataPtr también actúa como un valor único que la aplicación puede usar para identificar este parámetro con valores de tabla cuando se usa el enlace de fila variable. |
| StringLengthPtr | SQL_DESC_OCTET_LENGTH_PTR | SQL_DESC_OCTET_LENGTH_PTR Para un parámetro con valores de tabla, éste es el número de filas que se van a transferir o SQL_DATA_AT_EXEC. Se trata de un puntero a un valor que contiene el número de filas que se van a transferir con SQLExecDirect. |
| IndicatorPtr | SQL_DESC_INDICATOR_PTR | SQL_DESC_INDICATOR_PTR |
Para obtener más información sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).
SQLSetDescRec admite las características mejoradas de fecha y hora
Los valores permitidos para los tipos de fecha y hora son los siguientes:
| Tipo | Subtipo | Longitud | Precisión | Escala | |
|---|---|---|---|---|---|
| datetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| date | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| time | SQL_SS_TIME2 | 0 | 10 | 0..7 | 0..7 |
| datetime2 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 16 | 0..7 | 0..7 |
| datetimeoffset | SQL_SS_TIMESTAMPOFFSET | 0 | 20 | 0..7 | 0..7 |
Para obtener más información, vea Mejoras de fecha y hora (ODBC).
SQLSetDescRec admite UDT CLR grandes
SQLSetDescRec admite tipos CLR definidos por el usuario (UDT) grandes. Para obtener más información, vea Tipos de User-Defined CLR grandes (ODBC).