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 codeDescription
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

Target platform

Desktop

Version

Available in Windows Server 2003 R2, Windows Vista, and later versions of Windows.

Header

Wdm.h (include Wdm.h)

Library

Clfs.lib

DLL

Clfs.sys

IRQL

<= APC_LEVEL

See also

ClfsMgmtRegisterManagedClient

 

 

Send comments about this topic to Microsoft

Show: