Función JetOSSnapshotPrepare

Se aplica a: Windows | Windows Server

Función JetOSSnapshotPrepare

La función JetOSSnapshotPrepare inicia los preparativos para una sesión de instantáneas. Una sesión de instantáneas es un intervalo de tiempo corto en el que el motor no emite ninguna E/S de escritura en disco, con lo cual el motor puede participar en una sesión de instantáneas de volumen (si está controlado mediante un generador de instantáneas).

Windows XP:JetOSSnapshotPrepare se presenta en Windows XP.

    JET_ERR JET_API JetOSSnapshotPrepare(
      __out         JET_OSSNAPID* psnapId,
      __in          const JET_GRBIT grbit
    );

Parámetros

psnapId

Identificador de la sesión de instantáneas que se va a iniciar.

grbit

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

Valor	Significado
0	Instantánea normal.
JET_bitIncrementalSnapshot	Solo se tomarán los archivos de registro.
JET_bitCopySnapshot	Instantánea de copia (normal o incremental) sin truncamiento de registro.
JET_bitContinueAfterThaw	La sesión de instantánea se produce después de JetOSSnapshotThaw y requerirá una llamada a la función JetOSSnapshotEnd.
JET_bitExplicitPrepare	Ninguna instancia se preparará de forma predeterminada. Windows 7: JET_bitExplicitPrepare se presenta en Windows 7.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno siguientes. Para obtener más información sobre los posibles errores del ESE, consulte Errores del motor de almacenamiento extensible y Parámetros de control de errores.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errInvalidParameter	El puntero del identificador de instantánea es NULL o el parámetro grbit no es válido.
JET_errOSSnapshotInvalidSequence	Ya hay una sesión de instantánea en curso y la operación no puede tener más de una sesión de instantánea en un momento dado.

Si esta función se realiza correctamente, una sesión de instantánea podrá iniciarse en cualquier momento con la fase de inmovilización de E/S. Se devolverá el identificador de la sesión y se deberá usar en las llamadas posteriores para la sesión de instantáneas.

Las instancias en ejecución del motor ahora se considerarán parte de la sesión de instantáneas.

Windows Vista: para especificar un subconjunto diferente de instancias, se puede llamar a JetOSSnapshotPrepareInstance.

La llamada normal a la secuencia de API es: JetOSSnapshotPrepare, seguida opcionalmente de una o varias llamadas a JetOSSnapshotPrepareInstance y, por último, a JetOSSnapshotFreeze. Una vez iniciada la inmovilización, se puede finalizar mediante JetOSSnapshotThaw. En cualquier momento después de la preparación, la sesión de instantánea se puede finalizar abruptamente con JetOSSnapshotAbort.

Si se especifica JET_bitContinueAfterThaw después de JetOSSnapshotThaw, la sesión de instantáneas permanecerá (aunque se reanudará la E/S). Esto habilitará una comprobación de la instantánea y, si es necesario, habilitará el truncamiento del registro mediante JetOSSnapshotTruncateLog y requerirá una llamada a JetOSSnapshotEnd.

Si se produce un error en esta función, no se producirá ningún cambio en el estado del motor.

Comentarios

Las entradas del registro de eventos se generarán para los distintos pasos de la instantánea.

Requisitos

Requisito	Valor
Client	Requiere Windows Vista o Windows XP.
Server	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_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog