Share via


SQLGetDescRec

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics 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 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:

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

Consulte también

SQLGetDescRec
ODBC API Implementation Details