ATLPath::FileExists This function is an overloaded wrapper for PathFileExists inline BOOL FileExists( const char* pszPath ); inline BOOL FileExists( const wchar_t* pszPath ); Remarks See PathFileExists for details
pszPath [in] Pointer to a null-terminated string of maximum length MAX_PATH that contains the full path of the object to verify. Return Value
Returns TRUE if the file exists, or FALSE otherwise. Call GetLastError for extended error information.
Remarks
This function tests the validity of the path. It works only on the local file system or on a remote drive that has been mounted to a drive letter. It returns FALSE if a mounted remote drive is out of service.
// Invalid file path name (file is not there). char buffer_2[ ] = "C://TEST//file.doc"; char *lpStr2; lpStr2 = buffer_2;
// Return value from "PathFileExists". int retval;
// Search for the presence of a file with a true result. retval = PathFileExists(lpStr1); if(retval == 1) { cout << "Search for the file path of : " << lpStr1 << endl; cout << "The file requested /"" << lpStr1 << "/" is a valid file" << endl; cout << "The return from function is : " << retval << endl; }
else { cout << "/nThe file requested " << lpStr1 << " is not a valid file" << endl; cout << "The return from function is : " << retval << endl; }
// Search for the presence of a file with a false result. retval = PathFileExists(lpStr2);
if(retval == 1) { cout << "/nThe file requested " << lpStr2 << "is a valid file" << endl; cout << "Search for the file path of : " << lpStr2 << endl; cout << "The return from function is : " << retval << endl; } else { cout << "/nThe file requested /"" << lpStr2 << "/" is not a valid file" << endl; cout << "The return from function is : " << retval << endl; } }
OUTPUT ============== Search for the file path of : C:/TEST/file.txt The file requested "C:/TEST/file.txt" is a valid file The return from function is : 1
The file requested "C:/TEST/file.doc" is not a valid file The return from function is : 0 Function Information
Minimum DLL Version shlwapi.dll version 4.71 or later Custom Implementation No Header shlwapi.h Import library shlwapi.lib Minimum operating systems Windows 2000, Windows NT 4.0 with Internet Explorer 4.0, Windows 98, Windows 95 with Internet Explorer 4.0 Unicode Implemented as ANSI and Unicode versions.