Función JetGetCursorInfo

Se aplica a: Windows | Windows Server

Función JetGetCursorInfo

La función JetGetCursorInfo se usa para determinar si una actualización del registro actual de un cursor producirá un conflicto de escritura, en función del estado de actualización actual del registro. Es posible que se devuelva un conflicto de escritura, incluso si JetGetCursorInfo devuelve JET_errSuccess, ya que otra sesión puede actualizar el registro antes de que la sesión actual pueda actualizar el mismo registro.

    JET_ERR JET_API JetGetCursorInfo(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

Parámetros

sesid

Sesión que se usará para esta llamada.

tableid

Cursor que se usará para esta llamada.

pvResult

Reservado para uso futuro.

cbMax

Debe establecerse en 0 (cero), de lo contrario, no se usará. Está presente para la funcionalidad futura.

InfoLevel

Debe establecerse en 0 (cero), de lo contrario, no se usará. Está presente para la funcionalidad futura.

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_errInvalidParameter	CbMax no es 0 (cero) o InfoLevel no es 0 (cero).
JET_errNoCurrentRecord	El cursor no está actualmente en un registro y no se puede devolver información sobre un registro lógico como resultado.
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_errSessionSharingViolation	No se puede usar la misma sesión para más de un subproceso al mismo tiempo. Windows XP solo devolverá este error y versiones posteriores.
JET_errTermInProgress	No es posible completar la operación porque se está cerrando la instancia asociada a la sesión.
JET_errWriteConflict	El registro actual del cursor lo ha actualizado otra sesión y una actualización de este registro por esta sesión producirá un conflicto de escritura.

Si se ejecuta correctamente, esta operación no tiene ningún efecto en la ubicación del cursor, pero solo indica que ninguna otra sesión ha actualizado actualmente este registro.

Si se produce un error, si se devuelve un código de error negativo, no hay ningún efecto en el cursor o en la base de datos.

Comentarios

Esta operación no afecta al estado del cursor o de los datos. Solo devuelve un código de error que describe si se sabe que una actualización del registro actual por parte de la sesión que realiza la llamada da lugar a un JET_errWriteConflict o si no se conoce para devolver JET_errWriteConflict. Si otra sesión ya ha actualizado este registro para usarlo es seguro de que una actualización de este registro por esta sesión producirá un conflicto de escritura. Esto será así hasta que esta sesión se confirme o revierte sus transacciones al nivel de transacción 0 (cero). Sin embargo, si JetGetCursorInfo devuelve JET_errSuccess, todavía es posible que otra sesión actualice este registro antes de la sesión actual y, por tanto, sigue siendo posible que una actualización del registro actual por esta sesión en su transacción actual produzca un conflicto de escritura.

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_ERR
JET_SESID
JET_TABLEID
JetGetLock
JetPrepareUpdate
JetStopService
JetUpdate