metadata_cache_enabled Property

Whether the metadata cache should be used.

Syntax

def get_metadata_cache_enabled() -> bool: ...
def set_metadata_cache_enabled(value: bool) -> None: ...

metadata_cache_enabled = property(get_metadata_cache_enabled, set_metadata_cache_enabled)

Default Value

TRUE

Remarks

This property controls whether the file metadata cache is enabled for a virtual drive. The size of the file metadata cache can be controlled using the metadata_cache_size property.

When enabled, the class caches file information obtained via on_enumerate_directory and on_get_file_info events and uses the cached metadata to serve operating system requests, thus reducing how often the on_get_file_info events fire.

While a file or directory is open, its metadata is kept available in a special record called a File Control Block, regardless of whether the metadata cache is enabled.

For closed files and directories, the metadata is kept in the cache for the time, defined by the UnusedMetadataLifetime configuration setting.

Please refer to the Caching topic for more information.

Note: This property cannot be changed within events.