Función JetEndSession

  • Artículo

Se aplica a: Windows | Windows Server

Función JetEndSession

La función JetEndSession finaliza la sesión y limpia y desasigna los recursos asociados a la sesión especificada.

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parámetros

sesid

Sesión que se va a finalizar. Los recursos asociados se liberan cuando finaliza la sesión.

grbit

Reservado. Este parámetro puede contener la marca JET_bitForceSessionClosed, pero esta marca está reservada y establecerla no tiene ningún efecto.

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_errInvalidParameter

Uno de los parámetros proporcionados contenía un valor inesperado o la combinación de varios valores de parámetro produjo un resultado inesperado.

JET_errInvalidSesid

La sesión no era una sesión jet válida.

JET_errNotInitialized

No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.

JET_errOutOfMemory

Error en la operación porque no se pudo asignar memoria.

JET_errSessionInUse

Esto significa que la sesión estaba en uso en otro subproceso o la sesión no se estableció o restableció correctamente.

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_errOutOfBuffers

Error del sistema que indica que no hay más búferes.

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 identificador de sesión está cerrado y no está disponible, y se limpian todos los recursos relacionados con esta sesión.

En caso de error, hay varios errores adicionales que pueden producirse como parte del cierre de la tabla de ordenación, el cierre del cursor y la reversión de transacciones. Estos errores son bastante improbables y muy improbables si las sesiones no están completamente en uso cuando se llama a JetEndSession . Estos errores se devolverán si alguna parte de la sesión no se pudo limpiar correctamente.

Comentarios

Esta API revertirá todas las transacciones abiertas (no confirmadas en el nivel 0). También se limpiarán todos los cursores asociados a esta sesión y se limpiarán todas las tablas de ordenación que se hayan creado o abierto.

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_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService