Game Accessibility Suite: CATFileSystem::FindFirst

virtual CATResult CATFileSystem::FindFirst	(	const CATString &	searchMask,
		CATString &	firstFile,
		CATFINDHANDLE &	findHandle
	)			`[pure virtual]`

FindFirst() finds the first matching file or directory and returns it in firstFile.

FindFirst *must* be called prior to FindNext(). You must call FindEnd() when done.

Parameters:

	searchMask	- mask for performing searches with
	firstFile	- ref to a string that receives the filename on success.
	findHandle	- ref to handle returned on success.

Returns:: CATResult - CAT_STAT_PATH_IS_DIRECTORY if entry is a directory. CAT_STAT_PATH_IS_FILE if it's a file. CAT_ERR_FIND_NO_MATCHES if no matches are found.