Función SetLogArchiveTail (clfsw32.h)

  • Artículo

Establece el último número de secuencia de registro archivado (LSN) o el final del archivo de un registro archivable.

Sintaxis

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

Parámetros

[in] hLog

Identificador del registro que se obtiene de CreateLogFile.

El identificador de registro puede hacer referencia a un registro dedicado o multiplexado.

[in] plsnArchiveTail

Puntero a una estructura de CLFS_LSN que especifica un LSN físico válido en el registro.

Nota Para los identificadores de un registro físico o una secuencia de registro, plsnArchiveTail es un LSN físico, ya que hace referencia a una dirección de registro en el registro físico.
 

[in, out, optional] pReserved

Este parámetro está reservado y debe establecerse en NULL.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

En la lista siguiente se identifican los posibles códigos de error:

Comentarios

Si hay contextos de archivo obtenidos de PrepareLogArchive que no finalizan con TerminateLogArchive, el cambio no surte efecto hasta que se completen todos los archivos. Aunque hay contextos de archivo pendientes, solo se aplica la cola de archivo más grande.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado clfsw32.h
Library Clfsw32.lib
Archivo DLL Clfsw32.dll

Consulte también

CLFS_LSN

Funciones comunes del sistema de archivos de registro

OVERLAPPED

RemoveLogContainer

RemoveLogContainerSet