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

La 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 JET_ERR tipo de datos 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. Este error solo lo devolverá Windows XP 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 una operación de restauración está en curso en la instancia asociada a la sesión.

JET_errTermInProgress

No es posible completar la operación porque la instancia asociada a la sesión se está cerrando.

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.

Si se produce un 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 Valor

Cliente

Requiere Windows Vista o Windows XP.

Server

Requiere Windows Server 2008 o Windows Server 2003.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

Archivo DLL

Requiere ESENT.dll.

Vea también

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService