Compartir a través de

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 el flujo de registro CLFS cuyo final debe estar avanzado.

[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.

Observaciones

Se llama a la función ClfsAdvanceTailCall back cuando el cliente solicita que el cliente avance el final del registro.

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

  1. Si no se puede procesar la solicitud, devuelva un estado de error.
  2. Si la solicitud se puede procesar, cree y 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 clfsMgmtRegisterRegisterManagedClient para registrarse con la administración de CLFS, el cliente proporciona un puntero al función ClfsAdvanceTailCallback y los datos personalizados que se pasarán como parámetro al ClfsAdvanceTailCallback función cuando se llame a esta función.

Requisitos

Requisito Valor
cliente mínimo admitido Compatible con Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
de la plataforma de destino de Escritorio
encabezado de wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
irQL Llamado en IRQL <= APC_LEVEL

Consulte también

CLFS_MGMT_CLIENT_REGISTRATION

ClfsAdvanceLogBase

ClfsMgmtRegisterManagedClient

ClfsMgmtTailAdvanceFailure