Función JetStopBackup

Se aplica a: Windows | Windows Server

Función JetStopBackup

La función JetStopBackup impide que cualquier 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: Esta función se introduce en Windows XP.

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 JetStopBackup(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 ejecuta correctamente, la instancia 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án pasos para preparar la terminación de copia de seguridad en la instancia y no se producirá ningún cambio en el estado de la instancia.

Observaciones

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 que se produzcan errores. 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 la copia de seguridad (como JetEndExternalBackupInstance).

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

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService