SQLNumResultCols

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Per le istruzioni eseguite, il driver ODBC di SQL Server Native Client non visita il server per segnalare il numero di colonne in un set di risultati. In questo caso, SQLNumResultCols non causa un round trip del server. Analogamente a SQLDescribeCol e SQLColAttribute, la chiamata di SQLNumResultCols in istruzioni preparate ma non eseguite genera un round trip del server.

Quando un batch di istruzioni o istruzioni Transact-SQL restituisce più set di righe di risultati, è possibile che il numero di colonne del set di risultati cambi da un set a un altro. È necessario chiamare SQLNumResultCols per ogni set. Quando il numero di colonne cambia, l'applicazione deve riassociare i valori dei dati prima di recuperare i risultati delle righe. Per altre informazioni sulla gestione di più set di risultati restituiti, vedere SQLMoreResults.

I miglioramenti apportati al motore di database a partire da SQL Server 2012 (11.x) consentono a SQLNumResultCols di ottenere descrizioni più accurate dei risultati previsti. Questi risultati più accurati possono differire dai valori restituiti da SQLNumResultCols nelle versioni precedenti di SQL Server. Per altre informazioni, vedere Metadata Discovery.

Vedi anche

Funzione SQLNumResultCols
Dettagli di implementazione dell'API ODBC