PLOG_TAIL_ADVANCE_CALLBACK callback function (clfsmgmtw32.h)

Article
02/22/2024

The LOG_TAIL_ADVANCE_CALLBACK function is an application-defined callback function that advances the log tail. The callback is invoked in the context of an asynchronous procedure call (APC) on the thread that registers for log management.

Syntax

PLOG_TAIL_ADVANCE_CALLBACK PlogTailAdvanceCallback;

void PlogTailAdvanceCallback(
  [in] HANDLE hLogFile,
  [in] CLFS_LSN lsnTarget,
  [in] PVOID pvClientContext
)
{...}

Parameters

[in] hLogFile

The handle to the log.

[in] lsnTarget

Specifies the log sequence number (LSN) to which the client is advised to advance to or beyond. The lsnTarget may not refer to an actual record in the log.

[in] pvClientContext

A pointer to the client context.

Return value

None

Remarks

This callback can be invoked at any time. This callback function should advance the base LSN of the log to greater than or equal to the value of lsnTarget.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 R2 [desktop apps only]
Target Platform	Windows
Header	clfsmgmtw32.h