SQLNumResultCols

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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. SQLNumResultCols ne provoque alors pas de boucle de serveur. À l'instar de SQLDescribeCol et SQLColAttribute, l'appel de SQLNumResultCols sur des instructions préparées mais non exécutées génère une boucle de serveur.

Quand un lot d’instructions Ou d’instructions Transact-SQL retourne plusieurs jeux de lignes de résultat, il est possible que le nombre de colonnes de 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 réassocier les valeurs de données avant d'extraire les résultats de ligne. Pour plus d'informations sur la gestion de plusieurs retours de jeux de résultats, consultez SQLMoreResults.

Les améliorations apportées au moteur de base de données à compter de SQL Server 2012 (11.x) 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 Découverte des métadonnées.

Voir aussi

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