This topic has not yet been rated - Rate this topic

ClfsMgmtTailAdvanceFailure routine

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

Syntax


NTSTATUS ClfsMgmtTailAdvanceFailure(
  _In_  CLFS_MGMT_CLIENT Client,
  _In_  NTSTATUS Reason
);

Parameters

Client [in]: A pointer to the client. This is the value that was obtained through a call to the ClfsMgmtRegisterManagedClient routine.
Reason [in]: 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