FlushLogToLsn function (clfsw32.h)

Forces all records appended to this marshaling area up to the record with the specified log sequence number (LSN) to be flushed to the disk. More records than specified may be flushed during this operation.

Syntax

CLFSUSER_API BOOL FlushLogToLsn(
  [in]                PVOID        pvMarshalContext,
  [in]                PCLFS_LSN    plsnFlush,
  [out, optional]     PCLFS_LSN    plsnLastFlushed,
  [in, out, optional] LPOVERLAPPED pOverlapped
);

Parameters

[in] pvMarshalContext

A pointer to the marshaling context that is allocated by using the CreateLogMarshallingArea function.

[in] plsnFlush

A pointer to a CLFS_LSN structure that specifies the LSN that is used to determine which records to flush.

Specify CLFS_LSN_NULL to flush all records in the marshaling area.

[out, optional] plsnLastFlushed

A pointer to a CLFS_LSN structure.

The LSN returned is greater than the LSN of any record flushed. If the function succeeds, the value of the LSN is never less than plsnFlush. This value is meaningful only when the function succeeds.

[in, out, optional] pOverlapped

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

This parameter can be NULL except for an asynchronous operation.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call GetLastError. The following list identifies the possible error codes:

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Target Platform Windows
Header clfsw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

See also

CLFS_LSN

Common Log File System Functions

OVERLAPPED