AIT_FileExists
- Organization of this page
Description
Checks whether the file with a specified attribute exists.
Format
integer AIT_FileExists ( string strFileName // Filename [,integer nFileAttributes] // File attribute );
Parameters
strFileName (input)
Specify the name of a file to be found.
nFileAttributes (input, optional)
Specify a file attribute, which must be one of the following values.
Value |
Description |
---|---|
FILE_ATTRIBUTE_DIRECTORY |
The file is a directory. |
FILE_ATTRIBUTE_HIDDEN |
The file is a hidden one. |
FILE_ATTRIBUTE_SYSTEM |
The file is part of the OS, or is OS-specific. |
FILE_ATTRIBUTE_ARCHIVE |
The file is an archive one. The application uses this attribute as a mark for file backup or deletion. |
FILE_ATTRIBUTE_READONLY |
The file is a read-only one. The application can read the file, but cannot program and delete it. |
By default, a file is detected independent of the file attribute.
Return values
The return value is 1 if the file exists, and 0 if not. If the function has not been executed successfully, the return value is -1. If -1 has been returned, you can use AIT_GetLastError to acquire an extended error code. The following gives the error codes that AIT_GetLastError might return:
Extended error number |
Error code |
---|---|
2 |
ERROR_FILE_NOT_FOUND |
3 |
ERROR_PATH_NOT_FOUND |
5 |
ERROR_ACCESS_DENIED |
6 |
ERROR_INVALID_HANDLE |
8 |
ERROR_NOT_ENOUGH_MEMORY |
14 |
ERROR_OUTOFMEMORY |
15 |
ERROR_INVALID_DRIVE |
21 |
ERROR_NOT_READY |
53 |
ERROR_BAD_NETPATH |
87 |
ERROR_INVALID_PARAMETER |
112 |
ERROR_DISK_FULL |
123 |
ERROR_INVALID_NAME |
148 |
ERROR_PATH_BUSY |
161 |
ERROR_BAD_PATHNAME |
998 |
ERROR_NOACCESS |
1005 |
ERROR_UNRECOGNIZED_VOLUME |
1210 |
ERROR_INVALID_COMPUTERNAME |
1214 |
ERROR_INVALID_NETNAME |
1231 |
ERROR_NETWORK_UNREACHABLE |