SQLRowCount

Si applica a: SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureAzure Synapse AnalyticsPiattaforma di strumenti analitici (PDW)

Quando vengono associate matrici di valori di parametro per l'esecuzione di istruzioni, SQLRowCount restituisce SQL_ERROR se qualsiasi riga di valori di parametro genera una condizione di errore nell'esecuzione dell'istruzione. Tramite l'argomento RowCountPtr della funzione non viene restituito alcun valore.

L'applicazione può sfruttare l'attributo di istruzione SQL_ATTR_PARAMS_PROCESSED_PTR per acquisire il numero di parametri elaborati prima del verificarsi dell'errore.

L'applicazione può inoltre utilizzare una matrice di valori di stato, associata tramite l'attributo di istruzione SQL_ATTR_PARAM_STATUS_PTR, per acquisire gli offset della matrice di righe di parametri con errori. L'applicazione può attraversare la matrice di stati per determinare il numero effettivo di righe elaborate.

Quando viene eseguito un Transact-SQL INSERT, UPDATE, DELETE, o MERGE un'istruzione con una clausola OUTPUT, SQLRowCount non restituirà il conteggio delle righe interessate finché tutte le righe del set di risultati generate dalla clausola OUTPUT non saranno state consumate. Per utilizzare queste righe, chiamare SQLFetch o SQLFetchScroll. SQLResultCols restituirà -1 finché non verranno utilizzate tutte le righe dei risultati. Dopo che SQLFetch o SQLFetchScroll restituisce SQL_NO_DATA, l'applicazione deve chiamare SQLRowCount per determinare il numero di righe interessate prima di chiamare SQLMoreResults per passare al risultato successivo.

Vedi anche

Funzione SQLRowCount
Dettagli di implementazione dell'API ODBC