[This is preliminary documentation and is subject to change.]

When overriden in derived class retrieves the next file in a directory of the plugin's file system

Namespace:  Tools.TotalCommanderT
Assembly:  Tools.TotalCommander (in Tools.TotalCommander.dll) Version: 1.5.2.0

Syntax

C#
public abstract bool FindNext(
	Object Status,
	ref FindData FindData
)
Visual Basic (Declaration)
Public MustOverride Function FindNext ( _
	Status As Object, _
	ByRef FindData As FindData _
) As Boolean
Visual C++
public:
virtual bool FindNext(
	Object^ Status, 
	FindData% FindData
) abstract
J#
public abstract boolean FindNext(
	Object Status,
	/** @ref */FindData FindData
)
JScript
public abstract function FindNext(
	Status : Object, 
	FindData : FindData
) : boolean

Parameters

Status
Type: System..::.Object
The object returned by FindFirst(String, FindData%); null when Total Commander supplied handle that is not in HandleDictionary
FindData
Type: Tools.TotalCommanderT..::.FindData %
A FindData struct (mimics WIN32_FIND_DATA as defined in the Windows SDK) to be pupulated with the file or directory details. Use the Attributes field set to Directory to distinguish files from directories. On Unix systems, you can | (or) the Attributes field with 0x80000000 and set the ReparsePointTag parameter to the Unix file mode (permissions).

Return Value

Return false if there are no more files, and true otherwise. [M:SetLastError(System.UInt32!System.Runtime.CompilerServices.IsLong)]() does not need to be called.

Remarks

Note:
Do not thow any other exceptions. Such exception will be passed to Total Commander which cannot handle it.

Exceptions

ExceptionCondition
System.IO..::.DirectoryNotFoundExceptionDirectory does not exists
System..::.UnauthorizedAccessExceptionThe user does not have access to the directory
System.Security..::.SecurityExceptionSecurity error detected
System.IO..::.IOExceptionAnother error occured

See Also