Partager via

SQLNumResultCols

  • Article

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 d’instructions préparées mais non exécutées génère un aller-retour de serveur.

Lorsqu’une instruction Transact-SQL ou un lot d’instructions 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 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