Función JetGotoPosition

Se aplica a: Windows | Windows Server

Función JetGotoPosition

La función JetGotoPosition mueve un cursor a una nueva ubicación que es una fracción del camino a través del índice actual. La fracción es aproximadamente igual a la siguiente:

precpos-centriesLT>/precpos-centriesTotal>

Esta operación se realiza en respuesta a la entrada del cuadro de desplazamiento del usuario que se recibe cuando el usuario intenta mostrar los datos que inician una parte a través de un conjunto de datos.

    JET_ERR JET_API JetGotoPosition(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_RECPOS* precpos
    );

Parámetros

sesid

La sesión que se va a usar para esta llamada.

tableid

Cursor que se va a usar para esta llamada.

precpos

Descripción de la fracción que se va a usar para colocar el cursor en el índice actual.

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 se pudo 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 se pudo 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: Este valor devuelto se introduce en Windows XP.
JET_errInvalidParameter	El precpos-cbStruct> dado no es un tamaño válido para la estructura de JET_RECPOS o precpos-centriesLT> es mayor que precpos-centriesTotal>.
JET_errNotInitialized	La operación no se puede completar porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errRecordNotFound	Este error se devolverá si el índice está vacío.
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_errSessionSharingViolation	No se puede usar la misma sesión para más de un subproceso al mismo tiempo. Windows XP: Este valor devuelto se introduce en Windows XP.
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 ejecuta correctamente, el cursor se mueve a un registro actual que es una fracción del camino a través del índice donde la fracción es precpos-centriesLT dividida por precpos-centriesTotal>>.

Si se produce un error en esta función, la ubicación del cursor se deja sin cambios.

Comentarios

Esta operación mueve el cursor a través de la tabla a una posición en el siguiente punto aproximado: precpos-centriesLT> dividido por precpos-centriesTotal>.

Cuando se producen actualizaciones continuamente en la tabla, las llamadas posteriores con el mismo JET_RECPOS pueden mover el cursor a diferentes posiciones del índice, tanto antes como después de la posición anterior. El aislamiento transaccional no se aplica al posicionamiento a través de JET_RECPOS , ya que depende de las propiedades físicas del índice que no están aisladas de transacciones.

JET_RECPOS no debe usarse para describir un registro dentro de una tabla o para cambiar la posición de un registro cerca de un registro existente. En su lugar, los marcadores de un registro existente deben recuperarse después de una jetGotoPosition inicial y, a continuación, se usarán para cambiar la posición del mismo registro.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RECPOS
JET_SETINFO