Función JetGetLogInfo

Se aplica a: Windows | Windows Server

Función JetGetLogInfo

La función JetGetLogInfo se usa durante una copia de seguridad iniciada por JetBeginExternalBackup para consultar una instancia de los nombres de los archivos de revisión de base de datos y los archivos de registro de transacciones que deben formar parte del conjunto de archivos de copia de seguridad. Estos archivos se pueden abrir posteriormente mediante JetOpenFile y leerlos mediante JetReadFile.

    JET_ERR JET_API JetGetLogInfo(
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Parámetros

Szz

El búfer de salida que recibirá la lista de cadenas terminadas en null que describen el conjunto de archivos de revisión de base de datos y archivos de registro de transacciones que deben formar parte del conjunto de archivos de copia de seguridad.

La lista de cadenas devueltas en este búfer tiene el mismo formato que una cadena múltiple usada por el Registro. Cada cadena terminada en null se devuelve en secuencia seguida de un terminador nulo final.

cbMax

Tamaño máximo en bytes del búfer de salida.

pcbActual

Recibe la cantidad real de datos de cadena recibidos en el búfer de salida.

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_errBackupAbortByServer	Error en la operación porque la copia de seguridad externa actual se ha anulado mediante una llamada a JetStopBackup. Windows XP solo devolverá este error y versiones posteriores.
JET_errClientRequestToStopJetService	No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService.
JET_errInstanceUnavailable	No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP solo devolverá este error y versiones posteriores.
JET_errInvalidBackupSequence	Error en la operación de copia de seguridad porque se ha llamado fuera de secuencia. JetGetLogInfo devolverá este error si hay algún identificador de archivo pendiente creado mediante JetOpenFile para la instancia.
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir para JetGetLogInfo cuando el identificador de instancia especificado no es válido (Windows XP y versiones posteriores).
JET_errNoBackup	Error en la operación porque no hay ninguna copia de seguridad externa en curso.
JET_errNotInitialized	No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errRestoreInProgress	No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión.
JET_errRunningInMultiInstanceMode	Error en la operación porque se intentó usar el motor en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia cuando ya existen varias instancias.
JET_errTermInProgress	No es posible completar la operación porque se está cerrando la instancia asociada a la sesión.

Si se ejecuta correctamente, la información solicitada sobre el conjunto de archivos de revisión de base de datos y los archivos de registro de transacciones que deben formar parte del conjunto de archivos de copia de seguridad se colocará en los búferes de salida donde se proporcione. La máquina de estado de copia de seguridad estará avanzada para que ya no se permita la copia de seguridad de los archivos de base de datos. Solo se permiten abrir archivos de revisión de base de datos y archivos de registro de transacciones para la copia de seguridad más allá de este punto.

En caso de error, el estado de los búferes de salida no está definido. El error provocará la cancelación de todo el proceso de copia de seguridad de la instancia.

Comentarios

Es importante tener en cuenta que esta API no devuelve un error o advertencia si el búfer de salida es demasiado pequeño para aceptar la lista completa de archivos que deben formar parte del conjunto de archivos de copia de seguridad. La aplicación siempre debe proporcionar un búfer para recibir el tamaño real de esta lista y usar esa información para determinar si la lista se ha truncado.

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.
Unicode	Se implementa como JetGetLogInfoW (Unicode) y JetGetLogInfoA (ANSI).

Consulte también

JET_ERR
JET_INSTANCE
JET_LOGINFO
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup