Condividi tramite


SQLRowCount

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 eseguita un'istruzione Transact-SQL INSERT, UPDATE, DELETE o MERGE con una clausola OUTPUT, SQLRowCount non restituisce il conteggio delle righe interessate fino a quando tutte le righe nel set di risultati generato dalla clausola OUTPUT non vengono utilizzate. Per annullare l'utilizzo di tali righe, chiamare SQLFetch o SQLFetchScroll. SQLResultCols restituisce -1 fino a quando tutte le righe di risultati non vengono utilizzate. Dopo che SQLFetch o SQLFetchScroll restituisce SQL_NO_DATA, l'applicazione deve chiamare SQLRowCount per determinare il numero di righe interessato prima di chiamare SQLMoreResults per passare al risultato successivo.