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