CRecordset::CheckRowsetError

Articolo
02/19/2013

Chiamato per gestire gli errori generati durante il recupero record.

virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Parametri

nRetCode
Un codice restituito della funzione API ODBC.Per informazioni dettagliate, vedere i commenti.

Note

Questa funzione membro virtuale gestisce gli errori che si verificano quando i record vengono recuperati e sono utili durante il recupero di massa di righe.È opportuno di eseguire l'override CheckRowsetError per applicare la gestione degli errori.

CheckRowsetError viene chiamato automaticamente in un'operazione di spostamento del cursore, come Apri, Requery, o qualsiasi operazione Sposta.Viene passato il valore restituito della funzione API ODBC SQLExtendedFetch.Nella tabella seguente sono elencati i possibili valori per il parametro nRetCode.

nRetCode	Descrizione
SQL_SUCCESS	Funzione completata correttamente, non sono disponibili informazioni aggiuntive disponibili.
SQL_SUCCESS_WITH_INFORMATION	La funzione ha completato correttamente, possibilmente con un errore non irreversibile.Informazioni aggiuntive possono essere ottenute chiamando SQLError.
SQL_NO_DATA_FOUND	Tutte le righe dal gruppo di risultati recuperate.
SQL_ERROR	Funzione non riuscita.Informazioni aggiuntive possono essere ottenute chiamando SQLError.
SQL_INVALID_HANDLE	La funzione non è riuscita a causa di un handle di ambiente, gestisce di connessione, o di handle non valide dell'istruzione.Indica un errore di programmazione.Non sono disponibili informazioni aggiuntive disponibili da SQLError.
SQL_STILL_EXECUTING	Una funzione che è stata avviata in modo asincrono è ancora in esecuzione.Notare che per impostazione predefinita, MFC mai passerà questo valore in CheckRowsetError; MFC continuare a chiamare più SQLExtendedFetch finché non restituiscono SQL_STILL_EXECUTING.

Per ulteriori informazioni su SQLError, vedere Windows SDK.Per ulteriori informazioni sul recupero di massa di righe, vedere l'articolo recordset: Recupero di massa di record (ODBC).