SQLNumResultCols

Pour les instructions exécutées, le pilote ODBC SQL Server Native Client ne visite pas le serveur pour signaler le nombre de colonnes dans un jeu de résultats. Dans ce cas, SQLNumResultCols ne provoque pas d’aller-retour de serveur. Comme SQLDescribeCol et SQLColAttribute, l’appel à SQLNumResultCols des instructions préparées mais non exécutées génère un aller-retour de serveur.

Lorsqu’un lot d’instructions ou d’instructions Transact-SQL retourne plusieurs jeux de lignes de résultats, il est possible que le nombre de colonnes du jeu de résultats passe d’un jeu à un autre. SQLNumResultCols doit être appelé pour chaque ensemble. Lorsque le nombre de colonnes change, l’application doit rebiner les valeurs de données avant d’extraire les résultats de ligne. Pour plus d’informations sur la gestion de plusieurs retours de jeu de résultats, consultez SQLMoreResults.

Les améliorations apportées au moteur de base de données à partir de SQL Server 2012 permettent à SQLNumResultCols 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 SQLNumResultCols dans les versions précédentes de SQL Server. Pour plus d’informations, consultez La découverte des métadonnées.

Voir aussi

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