SQLSetDescField

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

SQLSetDescField peut être utilisé pour définir des champs de descripteur pour les paramètres table et les colonnes de paramètres table. Pour plus d’informations sur les champs disponibles, consultez Les champs de descripteur de paramètre table et les champs de descripteur pour les colonnes constituantes des paramètres table.

Notes

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.

Si une tentative est effectuée pour définir SQL_SOPT_SS_PARAM_FOCUS sur l’ordinal d’un paramètre qui n’est pas un paramètre table, SQLSetStmtAttr retourne SQL_ERROR, et un enregistrement de diagnostic est créé avec SQLSTATE = HY024 et le message « Valeur d’attribut non valide ». SQL_SOPT_SS_PARAM_FOCUS n'est pas modifié quand SQL_ERROR est retourné.

La définition de SQL_SOPT_SS_PARAM_FOCUS sur 0 restaure l'accès aux enregistrements de descripteurs pour les paramètres.

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

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

Les fonctionnalités de date/heure ont été améliorées dans ODBC. Pour plus d'informations sur le champ de descripteur disponible avec les nouveaux types de date/heure, consultez Parameter and Result Metadata.

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

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

SQLSetDescField 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.

Prise en charge par SQLSetDescField des colonnes éparses

SQLSetDecField peut être utilisé pour définir SQL_SOPT_SS_NAME_SCOPE dans le descripteur de paramètre d’application (APD) sur les valeurs SQL_SS_NAME_SCOPE_EXTENDED et SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

Pour plus d’informations, consultez La prise en charge des colonnes éparses (ODBC).

Voir aussi

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