SQLDescribeParam

Pour décrire les paramètres d’une instruction SQL, le pilote ODBC SQL Server Native Client génère et exécute une instruction SELECT Transact-SQL lorsque SQLDescribeParam est appelé sur un handle d’instruction ODBC préparé. Les métadonnées du jeu de résultats déterminent les caractéristiques des paramètres de l’instruction préparée. SQLDescribeParam peut retourner n’importe quel code d’erreur que SQLExecute ou SQLExecDirect peut retourner.

Les améliorations apportées au moteur de base de données à partir de SQL Server 2012 permettent à SQLDescribeParam d’obtenir des descriptions plus précises des résultats attendus. Ces résultats plus précis peuvent différer des valeurs retournées par SQLDescribeParam dans les versions précédentes de SQL Server. Pour plus d’informations, consultez La découverte des métadonnées.

Nouveau dans SQL Server 2012, ParameterSizePtr retourne désormais une valeur qui s’aligne sur la définition de la taille, en caractères, de la colonne ou de l’expression du marqueur de paramètre correspondant tel que défini dans la spécification ODBC. Dans les versions précédentes de SQL Server Native Client, ParameterSizePtr peut être la valeur correspondante du SQL_DESC_OCTET_LENGTH type ou une valeur de taille de colonne non pertinente fournie à SQLBindParameter pour un type, dont la valeur doit être ignorée (SQL_INTEGERpar exemple).

Le pilote ne prend pas en charge l’appel de SQLDescribeParam dans les situations suivantes :

• Après SQLExecDirect pour toutes les instructions UPDATE ou DELETE Transact-SQL contenant la clause FROM.

• Pour toute instruction ODBC ou Transact-SQL contenant un paramètre dans une clause HAVING, ou par rapport au résultat d’une fonction SUM.

• Pour n’importe quelle instruction ODBC ou Transact-SQL en fonction d’une sous-requête contenant des paramètres.

• Pour les instructions ODBC SQL contenant des marqueurs de paramètres dans les deux expressions d’une comparaison, comme, ou des prédicats quantifiés.

• Pour toutes les requêtes où l’un des paramètres est un paramètre d’une fonction.

• Lorsqu’il existe des commentaires (/* */) dans la commande Transact-SQL.

Lors du traitement d’un lot d’instructions Transact-SQL, le pilote ne prend pas également en charge l’appel de SQLDescribeParam pour les marqueurs de paramètres dans les instructions après la première instruction du lot.

Lors de la description des paramètres des procédures stockées préparées, SQLDescribeParam utilise la procédure stockée système sp_sproc_columns pour récupérer les caractéristiques des paramètres. sp_sproc_columns pouvez signaler des données pour les procédures stockées dans la base de données utilisateur actuelle. La préparation d’un nom de procédure stockée complète permet à SQLDescribeParam de s’exécuter entre les bases de données. Par exemple, la procédure stockée système sp_who peut être préparée et exécutée dans n’importe quelle base de données comme suit :

SQLPrepare(hstmt, "{call sp_who(?)}", SQL_NTS);  

Exécution de SQLDescribeParam après la préparation réussie retourne un jeu de lignes vide lorsqu’il est connecté à n’importe quelle base de données, mais master. Le même appel, préparé comme suit, entraîne la réussite de SQLDescribeParam, quelle que soit la base de données utilisateur actuelle :

SQLPrepare(hstmt, "{call master..sp_who(?)}", SQL_NTS);  

Pour les types de données de grande valeur, la valeur retournée dans DataTypePtr est SQL_VARCHAR, SQL_VARBINARY ou SQL_NVARCHAR. Pour indiquer que la taille du paramètre de type de données de grande valeur est « illimitée », le pilote ODBC SQL Server Native Client définit ParameterSizePtr sur 0. Les valeurs de taille réelles sont retournées pour les paramètres standard varchar .

Pour lier un paramètre d’entrée de taille « illimité », les données à l’exécution doivent être utilisées. Il n’est pas possible de lier un paramètre de sortie de taille « illimité » (il n’existe aucune méthode pour la diffusion en continu de données à partir d’un paramètre de sortie, comme SQLGetData pour les jeux de résultats).

Pour les paramètres de sortie, une mémoire tampon doit être liée et si la valeur est trop grande, la mémoire tampon est remplie et un message SQL_SUCCESS_WITH_INFO et est retourné avec les « données de chaîne ; avertissement de troncation droite ». Les données tronquées sont ensuite ignorées.

Paramètres SQLDescribeParam et Table-Valued

Une application peut récupérer des informations de paramètre table pour une instruction préparée avec SQLDescribeParam. Pour plus d’informations, consultez Table-Valued métadonnées de paramètre pour les instructions préparées.

Pour plus d’informations sur les paramètres table en général, consultez Table-Valued Parameters (ODBC).

Prise en charge de SQLDescribeParam pour les fonctionnalités de date et d’heure améliorées

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

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

Prise en charge de SQLDescribeParam pour les UDT CLR volumineux

SQLDescribeParam 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

SQLDescribeParam, fonction
Détails de l’implémentation d’API ODBC