Función JetOSSnapshotEnd

Se aplica a: Windows | Windows Server

Función JetOSSnapshotEnd

La función JetOSSnapshotEnd notifica al motor que finalizó la sesión de instantáneas.

Windows Vista:JetOSSnapshotEnd se presenta en Windows Vista:.

    JET_ERR JET_API JetOSSnapshotEnd(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Parámetros

snapId

Identificador de la sesión de instantánea.

grbit

Las opciones de esta llamada. Este parámetro puede tener una combinación de los valores siguientes.

Value	Significado
0	Final correcto de la sesión de instantáneas.
JET_bitAbortSnapshot	Sesión de instantánea anulada.

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_errInvalidGrbit	Una de las opciones solicitadas no es válida, se usa incorrectamente o no se implementa.
JET_errOSSnapshotInvalidSequence	Ya hay una sesión de instantánea en curso. Esto no está permitido.
JET_errOSSnapshotInvalidSnapId	El identificador de la sesión de instantáneas no es válido.
JET_errOSSnapshotTimeOut	La sesión de instantáneas tenía un tiempo de espera interno antes de que se produjera esta llamada. Como resultado, las operaciones de E/S regresaron a la normalidad antes de realizar esta llamada.

Si esta función se realiza correctamente, se completará una sesión de instantáneas y se reanudará el comportamiento normal del motor. Se puede iniciar una nueva sesión de instantáneas más adelante.

Si se produce un error en esta función, el JET_errOSSnapshotTimeOut código de retorno devuelve y finaliza la sesión de instantánea actual, pero la inmovilización de las E/S durante el período de instantánea no se respeta internamente. Para todos los demás errores, el estado de la sesión de instantánea no se cambiará.

Comentarios

Esta función se llama solo si se llamó a JetOSSnapshotThaw con JET_bitContinueAfterThaw.

La sesión de instantánea debe completarse para que tenga lugar la verificación de instantáneas y el truncamiento del registro. Las entradas del registro de eventos se generarán para los distintos pasos de la instantánea.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista.
Servidor	Requiere Windows Server 2008.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

Parámetros de control de errores
Errores del motor de almacenamiento extensible
JET_ERR
JetOSSnapshotThaw