Export (0) Print
Expand All


Resets the cached view of the specified file.

ULONG FbwfRestoreFile(
   PWCHAR volume,
   PWCHAR path


[in] NULL terminated wide string containing the volume name.
[in] NULL terminated wide string containing the file name or directory.

Return Values

This function may return the following:

Return valueDescription
NO_ERRORThe operation completed successfully.
ERROR_ACCESS_DENIEDThe specified file is not currently being cached by the FBWF.
ERROR_FILE_NOT_FOUNDIf path refers to a directory or non-existent file.
ERROR_INVALID_DRIVEThe specified volume is valid but does not exist or is not protected.
ERROR_INVALID_FUNCTIONIf the parameter path refers to is a write-through file, a file which has been renamed, or a cached file which does not exist on the physical media.
ERROR_INVALID_PARAMETERIf the volume or path parameter is NULL.
ERROR_READ_ONLYIf path refers to a read-only file.


This function effectively discards the cached image of the specified file. When the file is again written to, the cache will be rebuilt from the physical image and the changes will take place on the cached image.


OS Versions: Windows XP Embedded.
Header: fbwfapi.h.
Link Library: fbwflib.lib.

See Also

FBWF API | FbwfCommitFile

© 2006 Microsoft Corporation. All rights reserved.

© 2014 Microsoft