NonExistentFilesCacheEnabled Property

Whether the nonexistent files cache should be used.

Syntax

 cbfs.getNonExistentFilesCacheEnabled([callback])
 cbfs.setNonExistentFilesCacheEnabled( nonExistentFilesCacheEnabled, [callback])

Default Value

FALSE

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getNonExistentFilesCacheEnabled([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setNonExistentFilesCacheEnabled([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This property controls whether the nonexistent files cache is enabled for a virtual drive. The size of the nonexistent files cache can be controlled using the NonExistentFilesCacheSize property.

When enabled, the class will cache any GetFileInfo responses that indicate that the requested file does not exist. If another request is later made for the same file, the class will use this information to automatically report a "file not found" error rather than firing the GetFileInfo event again.

Please refer to the Caching topic for more information.

Note: This property cannot be changed within events.

This property is not available at design time.

Data Type

Boolean