Partager via


SQLGetDescRec

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Cette rubrique décrit les fonctionnalités SQLGetDescRec spécifiques à SQL Server Native Client.

SQLGetDescRec et paramètres table

SQLGetDescRec peut être utilisé pour obtenir des valeurs pour les attributs des paramètres table et des colonnes de paramètres table. Le paramètre RecNumber de SQLGetDescRec correspond au paramètre ParameterNumber de SQLBindParameter.

Les colonnes de paramètre table sont disponibles uniquement lorsque le champ d'en-tête de descripteur SQL_SOPT_SS_PARAM_FOCUS est défini sur l'ordinal d'un enregistrement pour lequel SQL_DESC_TYPE a la valeur SQL_SS_TABLE. Pour plus d’informations sur SQL_SOPT_SS_PARAM_FOCUS à propos de, consultez SQLSetStmtAttr.

SQLGetDescRec retourne les données suivantes :

Paramètre Paramètre table Colonnes de paramètre table et autres paramètres
Nom Nom de paramètre formel pour un appel de procédure stockée ; sinon, chaîne de longueur 0. Nom de la colonne de paramètre table.
TypePtr SQL_DESC_TYPE. Pour les paramètres table, il s'agit de SQL_SS_TABLE. SQL_DESC_TYPE
SubTypePtr Undefined SQL_DESC_DATETIME_INTERVAL_CODE (pour les enregistrements de type SQL_DATETIME ou SQL_INTERVAL.)
LengthPtr 0 SQL_DESC_OCTET_LENGTH
PrecisionPtr 0 SQL_DESC_PRECISION
ScalePtr 0 SQL_DESC_SCALE
NullablePtr 1 SQL_DESC_NULLABLE

Pour plus d’informations sur les paramètres table, consultez Paramètres table (ODBC) .

Prise en charge par SQLGetDescRec des fonctionnalités de date et heure améliorées

Les valeurs retournées pour les types date/heure sont les suivantes :

Attribut 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

Pour plus d’informations, consultez Améliorations de date et d’heure (ODBC).

Prise en charge par SQLSetDescRec des grands types CLR définis par l'utilisateur

SQLGetDescRec prend en charge les types clR définis par l’utilisateur (UDT). Pour plus d’informations, consultez Les types CLR définis par l’utilisateur (ODBC) volumineux.

Voir aussi

SQLGetDescRec
Détails de l’implémentation d’API ODBC