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.