Función JetStopBackupInstance

Se aplica a: Windows | Windows Server

Función JetStopBackupInstance

La función JetStopBackupInstance impide que la actividad relacionada con la copia de seguridad de streaming continúe en una instancia en ejecución específica, por lo que finaliza la copia de seguridad de streaming de forma predecible.

Windows XP:JetStopBackupInstance se presenta en Windows XP.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Parámetros

instance

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

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_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, la instancia especificada comenzará a generar errores en las nuevas API de copia de seguridad de streaming.

Si se produce un error en esta función, no se realizará ningún paso para preparar la finalización de la copia de seguridad en la instancia y no se producirá ningún cambio en el estado de la instancia.

Comentarios

Normalmente, una copia de seguridad se desencadena mediante un evento fuera del mecanismo de proceso y, mediante esta API, la propia aplicación ESENT realizará cualquier llamada adicional a las API de copia de seguridad de streaming para producir un error. La mayoría de las API de copia de seguridad de streaming comenzarán a generar errores con JET_errBackupAbortByServer. Por lo tanto, cualquier progreso de copia de seguridad de streaming (como JetReadFileInstance) devolverá un error. Todavía se permitirán las operaciones de copia de seguridad que forman parte de la terminación de copia de seguridad (como JetEndExternalBackupInstance).

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
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService