Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:SQL Server
Base de Dados SQL do Azure
Instância Gerida do Azure SQL
Azure Synapse Analytics
Para instruções executadas, o driver ODBC do SQL Server Native Client não visita o servidor para reportar o número de colunas num conjunto de resultados. Neste caso, o SQLNumResultCols não causa uma viagem de ida e volta ao servidor. Tal como o SQLDescribeCol e o SQLColAttribute, chamar SQLNumResultCols em instruções preparadas mas não executadas gera uma ida e volta do servidor.
Quando uma instrução Transact-SQL ou um lote de instruções devolve múltiplos conjuntos de linhas de resultados, é possível que o número de colunas do conjunto de resultados mude de um conjunto para outro. Devem ser chamados SQLNumResultCols para cada conjunto. Quando o número de colunas muda, a aplicação deve reatribuir os valores dos dados antes de obter os resultados das linhas. Para mais informações sobre como lidar com múltiplos retornos de conjuntos de resultados, consulte SQLMoreResults.
As melhorias no motor de base de dados a partir do SQL Server 2012 (11.x) permitem ao SQLNumResultCols obter descrições mais precisas dos resultados esperados. Estes resultados mais precisos podem diferir dos valores devolvidos pelo SQLNumResultCols em versões anteriores do SQL Server. Para mais informações, consulte Descoberta de Metadados.