CRecordset::CheckRowsetError

 

Chiamato per gestire gli errori generati durante il recupero record.

Sintassi

      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).

Eccezioni

Exception

Condition

Questo metodo può generare eccezioni di tipo CDBException*.

Requisiti

Header: afxdb.h

Vedere anche

CRecordset Class
Grafico delle gerarchie
CRecordset::DoBulkFieldExchange
CRecordset::GetRowsetSize
CRecordset::SetRowsetSize
CRecordset::Move