SQLSetDescRec

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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:

Atributo	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 grandes definidos por el usuario (UDT) clR grandes. Para obtener más información, vea Large CLR User-Defined Types (ODBC).

Consulte también

SQLSetDescRec
ODBC API Implementation Details