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.