SQLNumResultCols

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

Para instruções executadas, o SQL Server Native Client driver ODBC não visita o servidor para relatar o número de colunas em um conjunto de resultados. Nesse caso, SQLNumResultCols não provoca uma viagem de ida e volta ao servidor. Como SQLDescribeCol e SQLColAttribute, chamar SQLNumResultCols em instruções preparadas mas não executadas gera uma viagem de ida e volta ao servidor.

Quando uma instrução Transact-SQL ou um lote de instruções retorna vários conjuntos de linhas de resultado, é possível que o número de colunas do conjunto de resultados seja alterado de um conjunto para outro. SQLNumResultCols deve ser chamado para cada conjunto. Quando o número de colunas é alterado, o aplicativo deve associar novamente os valores de dados antes de buscar resultados de linha. Para obter mais informações sobre como manipular vários retornos de conjunto de resultados, consulte SQLMoreResults.

Melhorias no mecanismo de banco de dados começando com SQL Server 2012 (11.x) permitem que SQLNumResultCols obtenha descrições mais precisas dos resultados esperados. Esses resultados mais precisos podem ser diferentes dos valores retornados por SQLNumResultCols em versões anteriores do SQL Server. Para obter mais informações, veja Descoberta de metadados.

Consulte Também

Função SQLNumResultCols
ODBC API Implementation Details