ClfsMgmtTailAdvanceFailure function (wdm.h)
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 |
|---|---|
|
CLFS management has processed the notification that the log's tail could not be advanced. |
|
A NULL value was supplied for the Client parameter. |
|
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 |