CBFS Storage 2020 Node.js Edition

Questions / Feedback?

FindNext Method

Searches for the next vault item that matches an ongoing search operation.

Syntax

cbdrive.findNext(searchHandle, [callback])

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 this 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.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method searches for the next vault item (file, directory, symbolic link, or alternate stream) that matches the ongoing search operation identified by SearchHandle. If a matching vault item is found, this method returns true; otherwise it returns false.

The value passed for SearchHandle must be a search operation handle returned by FindFirst or FindFirstByQuery. Please refer to those methods' documentation for more information about search operations.

Note: This method can only be called when Active is true, and cannot be called within events.

Copyright (c) 2021 Callback Technologies, Inc. - All rights reserved.
CBFS Storage 2020 Node.js Edition - Version 20.0 [Build 7922]