PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK función de devolución de llamada (wdm.h)

  • Artículo

La función ClfsAdvanceTailCallback avanza el número de secuencia de registro base (LSN) del registro del cliente.

Sintaxis

PCLFS_CLIENT_ADVANCE_TAIL_CALLBACK PclfsClientAdvanceTailCallback;

NTSTATUS PclfsClientAdvanceTailCallback(
  [in] PLOG_FILE_OBJECT LogFile,
  [in] PCLFS_LSN TargetLsn,
  [in] PVOID ClientData
)
{...}

Parámetros

[in] LogFile

Puntero a una estructura de LOG_FILE_OBJECT que representa la secuencia de registro clFS cuya cola debe estar avanzada.

[in] TargetLsn

Puntero a una estructura de CLFS_LSN que contiene el LSN que el cliente debe avanzar hacia o más allá de su cola.

[in] ClientData

Puntero a la información proporcionada por el cliente. Especifique estos datos en el miembro AdvanceTailCallbackData de la estructura CLFS_MGMT_CLIENT_REGISTRATION .

Valor devuelto

La función ClfsAdvanceTailCallback debe devolver STATUS_PENDING o un estado de error. Un valor devuelto de STATUS_PENDING indica que la solicitud para mover el final del registro del cliente se completará de forma asincrónica. La función ClfsMgmtAdvanceTailCallback no debe devolver STATUS_SUCCESS, incluso si se completa de forma sincrónica.

Comentarios

Se llama a la función ClfsAdvanceTailCallback cuando la administración de CLFS solicita que el cliente avance el final del registro.

La función ClfsAdvanceTailCallback solo debe realizar una cantidad mínima de procesamiento antes de devolver. Por ejemplo, la función ClfsAdvanceTailCallback puede seguir este procedimiento:

  1. Si no se puede procesar la solicitud, devuelva un estado de error.
  2. Si se puede procesar la solicitud, cree y poner en cola un elemento de trabajo para realizar las acciones necesarias para mover el final del cliente y, a continuación, devuelva STATUS_PENDING. Para obtener más información sobre cómo poner en cola un subproceso de trabajo, consulte Subprocesos de trabajo del sistema.
Cuando un cliente llama a la rutina ClfsMgmtRegisterManagedClient para registrarse con la administración de CLFS, el cliente proporciona un puntero a la función ClfsAdvanceTailCallback y los datos personalizados que se pasarán como parámetro a la función ClfsAdvanceTailCallback cuando se llame a esta función.

Requisitos

Requisito Value
Cliente mínimo compatible Compatible con Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
IRQL Llamado en IRQL <= APC_LEVEL

Consulte también

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure