AdvanceLogBase function

Advances the base log sequence number (LSN) of a log stream to the specified LSN.

Syntax


BOOL WINAPI AdvanceLogBase(
  _Inout_     PVOID        pvMarshal,
  _In_        PCLFS_LSN    plsnBase,
  _In_        ULONG        fFlags,
  _Inout_opt_ LPOVERLAPPED pOverlapped
);

Parameters

pvMarshal [in, out]

A pointer to the marshaling context that a successful call to CreateLogMarshallingArea returns.

plsnBase [in]

The new base LSN for the log that is specified in pvMarshal.

This LSN must be in the range between the current base LSN and the last LSN of the log, inclusively.

fFlags [in]

This parameter is not implemented at this time, and must be zero.

pOverlapped [in, out, optional]

A pointer to an OVERLAPPED structure that is required for asynchronous operation.

If asynchronous operation is not used, this parameter can be NULL.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

The following list identifies the possible error codes:

ERROR_ACCESS_DENIED
ERROR_INVALID_PARAMETER
ERROR_INVALID_USER_BUFFER
ERROR_IO_PENDING
ERROR_LOG_TAIL_INVALID

Remarks

AdvanceLogBase might flush data and metadata when it is called.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Clfsw32.h

Library

Clfsw32.lib

DLL

Clfsw32.dll

See also

Obtaining the Next LSN

 

 

Community Additions

ADD
Show: