FlushViewOfFile
The FlushViewOfFile
function writes to the disk a byte range within a mapped view of a file.
BOOL FlushViewOfFile(
LPCVOID lpBaseAddress, |
// start address of
byte range to flush |
DWORD dwNumberOfBytesToFlush |
// number of bytes
in range |
); |
|
Parameters
lpBaseAddress
Points to the
base address of the byte range to be flushed to the disk representation of the
mapped file.
dwNumberOfBytesToFlush
Specifies the
number of bytes to flush.
If dwNumberOfBytesToFlush
is zero, the file is flushed from the base address to the end of the mapping.
Return Values
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
Remarks
Flushing a
range of a mapped view causes any dirty pages within that range to be written
to the disk. Dirty pages are those whose contents have changed since the file
view was mapped.
See Also