Función JetTerm2

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetTerm2

La función JetTerm2 inicia el apagado de una instancia inicializada por JetInit.

JetTerm2 también puede destruir una instancia no inicializada creada por JetCreateInstance.

    JET_ERR JET_API JetTerm2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Parámetros

instance

Instancia que se va a usar para esta llamada.

Windows 2000: Este parámetro se omite y siempre debe ser NULL.

Windows XP y versiones posteriores: Este parámetro está sobrecargado. Si el motor funciona en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia, este parámetro podría ser NULL o podría contener la instancia real devuelta por JetInit. Si el motor funciona en modo de varias instancias, este parámetro debe ser un puntero a una instancia que se creó mediante JetCreateInstance.

grbit

Grupo de bits que contienen las opciones que se usarán para esta llamada, que incluyen cero o más de los valores siguientes.

Value	Significado
JET_bitTermComplete	Solicita que la instancia se apague limpiamente. Cualquier trabajo de limpieza opcional que normalmente se realizaría en segundo plano en tiempo de ejecución se completa inmediatamente.
JET_bitTermAbrupt	Solicita que la instancia se apague lo antes posible. Cualquier trabajo opcional que normalmente se realizaría en segundo plano en tiempo de ejecución se abandona. Nota Esta opción puede provocar una pérdida de espacio temporal o permanente en la base de datos. Este espacio perdido siempre se puede recuperar a través de una desfragmentación sin conexión de la base de datos.
JET_bitTermStopBackup	Solicita que la instancia se apague incluso si actualmente hay una copia de seguridad en curso. Normalmente, una copia de seguridad pendiente provocaría un error de JetTerm con JET_errBackupInProgress. Cuando este parámetro no está presente, se supone que su valor es JET_bitTermAbrupt.
JET_bitTermDirty	Solicita que la instancia se apague con todas las bases de datos adjuntas que quedan en un estado desfasado. Windows 7: JET_bitTermDirty 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_errSuccess	La operación se ha completado correctamente.
JET_errBackupInProgress	La operación no se puede completar porque hay una operación de copia de seguridad en curso en la instancia de .
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o la combinación de varios parámetros produjo un resultado inesperado. JetTerm devolverá este error cuando el motor esté en modo de varias instancias y cuando la pinstancia haga referencia a una instancia no válida. Windows XP: Este valor devuelto se introduce en Windows XP.
JET_errNotInitialized	La operación no se puede completar porque la instancia aún no se ha inicializado.
JET_errTermInProgress	La operación no se puede completar porque la instancia se está cerrando.
JET_errRestoreInProgress	No es posible completar la operación porque una operación de restauración está en curso en la instancia de .
JET_errTooManyActiveUsers	No se puede apagar la instancia porque actualmente hay sesiones con transacciones activas para la instancia especificada. Este error solo se produce si se usa el JET_bitTermComplete.

Si esta función se ejecuta correctamente, se apagará la instancia especificada. El identificador de instancia también se cerrará y dejará de estar disponible para cualquier API que tome un identificador de instancia. Todos los demás objetos asociados a la instancia, como sesiones, también se cerrarán. El estado del archivo de punto de comprobación, los archivos de registro de transacciones y los archivos de base de datos adjuntos a la instancia se modificarán durante el proceso de apagado.

Si se produce un error en esta función como resultado de un error de uso, la instancia permanece en un estado inicializado y no cambia nada. De lo contrario, la instancia se sigue cerrando como se indica para el caso de éxito. La diferencia es que la instancia tendrá que pasar por la recuperación de bloqueos cuando se inicialice a continuación. El motor intentará vaciar tantos datos como sea posible para minimizar la cantidad de recuperación necesaria. Conceptualmente, este error de JetTerm no es diferente de un bloqueo de proceso.

Comentarios

Consulte JetTerm.

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

Archivos extensibles del motor de almacenamiento
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm

Función JetTerm2