Función JetResetTableSequential
Se aplica a: Windows | Windows Server
Función JetResetTableSequential
La función JetResetTableSequential notifica al motor de base de datos que la aplicación ya no examina todo el índice actual que contiene un cursor determinado. Esta llamada invierte una notificación enviada por JetSetTableSequential.
Windows XP:JetResetTableSequential se introduce en Windows XP.
JET_ERR JET_API JetResetTableSequential(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_GRBIT grbit
);
Parámetros
sesid
Sesión que se va a usar para esta llamada.
tableid
Cursor que se va a usar para esta llamada.
grbit
Reservado para uso futuro.
Valor devuelto
Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.
Código devuelto |
Descripción |
---|---|
JET_errSuccess |
La operación se ha completado correctamente. |
JET_errClientRequestToStopJetService |
No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService. |
JET_errInstanceUnavailable |
No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP solo devolverá este error y versiones posteriores. |
JET_errNotInitialized |
No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado. |
JET_errRestoreInProgress |
No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión. |
JET_errTermInProgress |
No es posible completar la operación porque se está cerrando la instancia asociada a la sesión. |
Si se ejecuta correctamente, el índice actual del cursor ya no está optimizado para un examen secuencial de todo el índice. No se producirá ningún cambio en el estado de la base de datos.
En caso de error, no se producirá ningún cambio en la configuración del cursor. No se producirá ningún cambio en el estado de la base de datos.
Comentarios
Es seguro realizar esta llamada en un cursor que no se haya configurado previamente mediante una llamada a JetSetTableSequential.
Requisitos
Requisito | Value |
---|---|
Cliente |
Requiere Windows Vista o Windows XP. |
Servidor |
Requiere Windows Server 2008 o Windows Server 2003. |
Encabezado |
Declarado en Esent.h. |
Library |
Use ESENT.lib. |
Archivo DLL |
Requiere ESENT.dll. |
Consulte también
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService