Compartir a través de


CRecordset::CheckRowsetError

Denominado para controlar los errores generados durante la obtención de registro.

virtual void CheckRowsetError( 
   RETCODE nRetCode  
);

Parámetros

  • nRetCode
    Un código de retorno de la función de la API de ODBC. Para obtener detalles, vea las notas.

Comentarios

Esta función miembro virtual controla los errores que se producen cuando se capturan los registros, y son útiles durante la obtención de filas masiva. Puede desear considerar reemplazar CheckRowsetError para implementar dispone de control de errores.

CheckRowsetError se llama automáticamente en una operación de navegación del cursor, como Abrir, Requery, o cualquier operación de Mover . se pasa el valor devuelto de la función API SQLExtendedFetchde ODBC. La tabla siguiente se muestran los valores posibles del parámetro de nRetCode .

nRetCode

Descripción

SQL_SUCCESS

Función completa correctamente; no hay información adicional disponible.

SQL_SUCCESS_WITH_INFORMATION

Función completada correctamente, posiblemente con un error no es grave. La información adicional puede obtenerse llamando a SQLError.

SQL_NO_DATA_FOUND

Todas las filas del conjunto de resultados se han capturado.

SQL_ERROR

Error de la función. La información adicional puede obtenerse llamando a SQLError.

SQL_INVALID_HANDLE

La función debido a un identificador no válido del entorno, el identificador de la conexión, o el identificador de instrucciones. esto indica un error de programación. no hay información adicional disponible de SQLError.

SQL_STILL_EXECUTING

Una función que se inició asincrónica todavía se está ejecutando. Observe que de forma predeterminada, MFC nunca pasa este valor a CheckRowsetError; MFC continuará llamando a SQLExtendedFetch hasta que devuelva ya no SQL_STILL_EXECUTING.

Para obtener más información sobre SQLError, vea Windows SDK. Para obtener más información sobre la obtención masiva de filas, vea el artículo conjunto de registros: Obtener registros de forma masiva (ODBC).

Excepciones

Este método puede producir excepciones de **CDBException***escrito.

Requisitos

encabezado: afxdb.h

Vea también

Referencia

CRecordset Class

Gráfico de jerarquías

CRecordset::DoBulkFieldExchange

CRecordset::GetRowsetSize

CRecordset::SetRowsetSize

CRecordset::Move