SQLGetDescRec
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
En este tema se describe la funcionalidad SQLGetDescRec específica de SQL Server Native Client.
SQLGetDescRec y parámetros con valores de tabla
SQLGetDescRec se puede usar para obtener valores para atributos de parámetros con valores de tabla y columnas de parámetros con valores de tabla. El parámetro RecNumber de SQLGetDescRec corresponde al parámetro ParameterNumber de SQLBindParameter.
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.
SQLGetDescRec devuelve los datos siguientes:
| Parámetro | Parámetro con valores de tabla | Columnas de parámetros con valores de tabla y otros parámetros |
|---|---|---|
| Nombre | El nombre del parámetro formal de una llamada de procedimiento almacenado; de lo contrario, una cadena de longitud 0. | El nombre de la columna de parámetros con valores de tabla. |
| TypePtr | SQL_DESC_TYPE. Para los parámetros con valores de tabla, es SQL_SS_TABLE. | SQL_DESC_TYPE |
| SubTypePtr | Undefined | SQL_DESC_DATETIME_INTERVAL_CODE (para registros de tipo SQL_DATETIME o SQL_INTERVAL). |
| LengthPtr | 0 | SQL_DESC_OCTET_LENGTH |
| PrecisionPtr | 0 | SQL_DESC_PRECISION |
| ScalePtr | 0 | SQL_DESC_SCALE |
| NullablePtr | 1 | SQL_DESC_NULLABLE |
Para obtener más información sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).
SQLGetDescRec admite las características mejoradas de fecha y hora
Los valores devueltos para los tipos de fecha y hora son los siguientes:
| Attribute | TypePtr | SubTypePtr | LengthPtr | PrecisionPtr | ScalePtr |
|---|---|---|---|---|---|
| datetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | 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).
SQLGetDescRec admite UDT CLR grandes
SQLGetDescRec admite tipos definidos por el usuario (UDT) clR grandes. Para obtener más información, vea Tipos definidos por el usuario (ODBC) clR grandes.