SQLRowCount

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

Quando matrizes de valores de parâmetro são associadas para execução de instrução, SQLRowCount retornará SQL_ERROR se qualquer linha de valores de parâmetro gerar uma condição de erro na execução da instrução. Nenhum valor é retornado pelo argumento RowCountPtr da função.

O aplicativo pode tirar proveito do atributo da instrução SQL_ATTR_PARAMS_PROCESSED_PTR para capturar o número de parâmetros processados antes de ocorrer o erro.

Além disso, o aplicativo pode usar uma matriz de valores de status, associada usando o atributo da instrução SQL_ATTR_PARAM_STATUS_PTR, para capturar os deslocamentos de matriz de linhas de parâmetro incorretas. O aplicativo pode atravessar a matriz de status para determinar o número real de linhas processadas.

Quando uma instrução TRANSact-SQL INSERT, UPDATE, DELETE ou MERGE com uma cláusula OUTPUT for executada, SQLRowCount não retornará a contagem de linhas afetadas até que todas as linhas no conjunto de resultados gerados pela cláusula OUTPUT sejam consumidas. Para consumir essas linhas, você chama SQLFetch ou SQLFetchScroll. SQLResultCols retornará -1 até que todas as linhas de resultado sejam consumidas. Depois que SQLFetch ou SQLFetchScroll retornar SQL_NO_DATA, o aplicativo deverá chamar SQLRowCount para determinar o número de linhas afetadas antes de chamar SQLMoreResults para passar para o próximo resultado.

Consulte Também

Função SQLRowCount
ODBC API Implementation Details