UseSystemCache Property

Whether the operating system's cache is used.


bool GetUseSystemCache();
int SetUseSystemCache(bool bUseSystemCache);

Default Value



This property specifies whether the operating system's cache should be used. Use of the OS cache affects the speed of various vault operations; however, note that the exact effects depend on the type of operation as well as the data sizes involved.

For the CBVault class, disabling this property will cause a vault's storage file (specified by the VaultFile property) to be opened with FILE_FLAG_NO_BUFFERING (on Windows) or F_NOCACHE (on Linux/macOS). This also applies for the CBDrive class on Linux and macOS.

For the CBDrive class on Windows, a vault's storage file is always opened with FILE_FLAG_NO_BUFFERING regardless of how this property is set; disabling this property prevents the system cache from being used to cache files on the virtual drive. This may be necessary in certain situations in order to prevent BSODs. Please refer to Microsoft's File Caching article for more information about the system file cache.

Note: This property cannot be changed when Active is true, and cannot be changed within events.

Data Type


Copyright (c) 2020 Callback Technologies, Inc. - All rights reserved.
CBFS Storage 2020 Qt Edition - Version 20.0 [Build 7649]