Compartir a través de

Función JetOSSnapshotTruncateLog

  • Artículo

Se aplica a: Windows | Windows Server

Función JetOSSnapshotTruncateLog

La función JetOSSnapshotTruncateLog habilita el truncamiento del registro para todas las instancias que forman parte de la sesión de instantáneas.

Windows Vista:JetOSSnapshotTruncateLog se presenta en Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __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.

Valor

Significado

JET_bitAllDatabasesSnapshot

Todas las bases de datos se adjuntan para que el motor de almacenamiento pueda calcular y realizar el truncamiento del registro.

0 (cero)

No se producirá ningún truncamiento.

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

El parámetro grbit no es válido.

JET_errOSSnapshotInvalidSequence

La sesión de instantánea no está en el estado en el que se puede producir un truncamiento. Las posibles causas son:

  • la llamada se realiza después de que se agote el tiempo de espera de la sesión de instantáneas.

  • la sesión se especificó como una instantánea de copia

Si se ejecuta correctamente, los archivos de registro de una o todas las instancias de la sesión de instantáneas se truncarán, si es posible.

Comentarios

Solo se debe llamar a esta función si la instantánea se creó con la opción JET_bitContinueAfterThaw. De lo contrario, la sesión de instantánea habría finalizado después de la llamada jetOSSnapshotThaw .

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
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw