Función JetStopService

Se aplica a: Windows | Windows Server

Función JetStopService

La función JetStopService prepara una instancia para la finalización.

JetStopService es la llamada heredada cuando solo se permite una instancia. En este caso, la única instancia activa es la que se prepara para la finalización.

    JET_ERR JET_API JetStopService(void);

Parámetros

Esta función no tiene parámetros.

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_errRunningInMultiInstanceMode	No está claro qué instancia debe prepararse para la terminación cuando se usa JetStopService con el modo de varias instancias. Windows XP: Este valor devuelto se introduce en Windows XP.

Si esta función se realiza correctamente, se prepara para una terminación futura. Entre los pasos que se deben seguir para preparar una terminación se incluyen los siguientes:

• Detenga la desfragmentación en línea si se está ejecutando.

• Inicie una limpieza del almacén de versiones.

• Reduzca la profundidad del punto de control empezando a vaciar páginas desfasadas en el administrador de búferes.

• Evite llamadas futuras a la mayoría de las funciones de esa instancia.

Si se produce un error en esta función, no se realizarán los pasos necesarios para preparar una terminación de instancia, por lo que no se producirá ningún cambio en el estado de la instancia.

Comentarios

Esta función reduce el trabajo que tendrá que hacer la instancia cuando termine, pero no finalizará la instancia. Como resultado, esta función es simplemente una optimización y no es obligatoria para su uso. Ten en cuenta que la cantidad de trabajo realizado en la preparación era menor en Windows 2000 y Windows XP. Una vez que la función se realiza correctamente, las funciones que ya no están permitidas devolverán JET_errClientRequestToStopJetService. Las funciones que todavía se permiten después de esta llamada son: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase y JetResetSessionContext.

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_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2