Función JetSetTableSequential

Se aplica a: Windows | Windows Server

Función JetSetTableSequential

La función JetSetTableSequential notifica al motor de base de datos que la aplicación está examinando todo el índice actual que contiene un cursor determinado. Por lo tanto, los métodos que se usan para acceder a los datos de índice se ajustarán para que este escenario sea lo más rápido posible.

Windows XP:JetSetTableSequential se introduce en Windows XP.

    JET_ERR JET_API JetSetTableSequential(
      __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

Grupo de bits que especifican cero o más de las siguientes opciones.

Value	Significado
JET_bitPrereadForward	Esta opción se usa para indexar en la dirección hacia delante. Windows 7:JET_bitPrereadForward se introduce en Windows 7.
JET_bitPrereadBackward	Esta opción se usa para indexar en la dirección hacia atrás. Windows 7:JET_bitPrereadBackward se introduce en Windows 7.

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_errClientRequestToStopJetService	La operación no se puede completar porque toda la actividad de la instancia asociada a la sesión se ha desactivado como resultado de una llamada a JetStopService.
JET_errInstanceUnavailable	La operación no se puede completar porque la instancia asociada a la sesión encontró un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP: este valor devuelto se introduce en Windows XP.
JET_errNotInitialized	La operación no se puede completar porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errRestoreInProgress	La operación no se puede completar porque hay una operación de restauración en curso en la instancia asociada a la sesión.
JET_errTermInProgress	La operación no se puede completar porque la instancia asociada a la sesión se está cerrando.

Si esta función se realiza correctamente, el índice actual del cursor se optimiza 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 en esta función, 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

Si la aplicación necesita examinar eficazmente un subconjunto conocido de un índice, también se realiza una optimización similar cada vez que se establece un intervalo de índice mediante JetSetIndexRange. Esta optimización solo está disponible en Windows XP y versiones posteriores.

Si la aplicación necesita examinar eficazmente un subconjunto desconocido de un índice, no se debe realizar ninguna acción. El motor puede detectar automáticamente el comportamiento del examen y capturará los datos con antelación. Sin embargo, este comportamiento no es tan agresivo.

Esta optimización hará que el examen del índice principal sea eficaz y hará que el examen de solo los datos de entrada de índice en un índice secundario sea eficaz. No hará que el examen de un índice secundario al recuperar los datos de registro sea eficaz. Esto se debe a que el motor no realiza una lectura anticipada en los datos de registro.

Requisitos

Requisito	Value
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
JetSetIndexRange
JetStopService