CRecordset::CheckRowsetError

Artículo
06/10/2015

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