Función JetStopServiceInstance

Se aplica a: Windows | Windows Server

Función JetStopServiceInstance

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

Windows XP:JetStopServiceInstance se introduce en Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Parámetros

instance

Instancia en ejecución que se va a usar para la llamada API.

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_errInvalidParameter	El parámetro de instancia especificado tiene un valor no válido (no una instancia que se está ejecutando actualmente). 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 reducirá 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 o Windows XP.
Servidor	Requiere Windows Server 2008 o Windows Server 2003.
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