Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se describe la funcionalidad SQLSetDescRec específica de SQL Server Native Client.
Parámetros SQLSetDescRec y Table-Valued
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 sobre SQL_SOPT_SS_PARAM_FOCUS, vea SQLSetStmtAttr.
En la tabla siguiente se describe la asignación entre parámetros y campos descriptores.
| Parámetro | Atributo relacionado para los tipos de parámetro sin valores de tabla, incluidas las columnas de parámetro con valores de tabla | Atributo relacionado para parámetros con valores de tabla |
|---|---|---|
| Tipo | SQL_DESC_TYPE | SQL_SS_TABLE |
| Subtipo | Omitido | Para los registros de tipo SQL_DATETIME o SQL_INTERVAL, establézcalo en SQL_DESC_DATETIME_INTERVAL_CODE. |
| Duración | SQL_DESC_OCTET_LENGTH | Longitud del nombre del tipo de parámetro con valores de tabla. Esto puede ser SQL_NTS si el nombre de tipo es nulo terminado o cero si no se requiere el nombre del tipo de parámetro con valores de tabla. |
| Precisión | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| Escalar | SQL_DESC_SCALE | No usado. Este parámetro debe 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 se puede especificar NULL si no es necesario. Este parámetro debe especificarse para las instrucciones SQL que no son llamadas a procedimiento. 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, este 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).
Compatibilidad con SQLSetDescRec para características mejoradas de fecha y hora
Los valores permitidos para los tipos de fecha y hora son los siguientes:
| Tipo | Subtipo | Duración | Precisión | Escalar | |
|---|---|---|---|---|---|
| fecha y hora | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| fecha | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| Tiempo | 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).
Compatibilidad con SQLSetDescRec para UDT clR grandes
SQLSetDescRec admite tipos definidos por el usuario (UDT) clR grandes. Para obtener más información, vea Tipos definidos por el usuario (ODBC) clR grandes.