FindFirst

CATResult CATFileSystem_Win32::FindFirst ( const CATString &  searchMask, CATString &  firstFile, CATFINDHANDLE &  findHandle   ) [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  - path/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. See also: FindNext(), FindEnd() Implements CATFileSystem. Definition at line 197 of file CATFileSystem_Win32.cpp. References CATFileSystem::BuildPath(), CAT_ERR_FIND_NO_MATCHES, CAT_STAT_PATH_IS_DIRECTORY, CAT_STAT_PATH_IS_FILE, CAT_SUCCESS, CATRESULTDESC, CATString::Compare(), CATFileSystem::fBasePath, fFindPaths, CATFileSystem::fFSLock, CATMutex::Release(), CATFileSystem::RemoveBasePath(), CATFileSystem::SplitPath(), and CATMutex::Wait().

---