SQLGetDescRec
S’applique à :
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Cette rubrique décrit la fonctionnalité SQLGetDescRec spécifique à 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, 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 | Indéfini | 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 grands types CLR définis par l’utilisateur (UDT). Pour plus d’informations, consultez Types de User-Defined CLR volumineux (ODBC).
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour