ClfsMgmtTailAdvanceFailure function (wdm.h)

Article
02/25/2022

The ClfsMgmtTailAdvanceFailure routine notifies CLFS management that the client could not advance the log's tail.

Syntax

CLFSUSER_API NTSTATUS ClfsMgmtTailAdvanceFailure(
  [in] CLFS_MGMT_CLIENT Client,
  [in] NTSTATUS         Reason
);

Parameters

[in] Client

A pointer to the client. This is the value that was obtained through a call to the ClfsMgmtRegisterManagedClient routine.

[in] Reason

A value that indicates why the log's tail could not be advanced.

Return value

The ClfsMgmtTailAdvanceFailure routine returns one of the following NTSTATUS values:

Return code	Description
STATUS_SUCCESS	CLFS management has processed the notification that the log's tail could not be advanced.
STATUS_INVALID_PARAMETER	A NULL value was supplied for the Client parameter.
STATUS_INVALID_PARAMETER_1	The value that was supplied for the Client parameter does not represent a valid client.

Remarks

If a client cannot advance its log's tail to or beyond the requested LSN, then the client must call the ClfsMgmtTailAdvanceFailure routine to indicate that it is not able to advance its tail. Until the client either moves its tail as requested or calls the ClfsMgmtTailAdvanceFailure routine, the client will not receive any further requests to move its tail.

The value of the Reason parameter is passed back to the client as the value of the OperationStatus parameter when the ClfsLogGrowthCompleteCallback function is invoked.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Server 2003 R2, Windows Vista, and later versions of Windows.
Target Platform	Desktop
Header	wdm.h (include Wdm.h)
Library	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL