This function is used to get creation and last change and access dates for a file or directory.
Note: Whether the creation or last access date is supported depends on the file system used as well as the system configuration. Even in Windows, for example, even though FAT and NTFS support the last access date, it is not necessarily present in all installations. Similarly, some Linux file systems do not store the file creation date. Only the change date is sent consistently in all cases.
If the information is not available, the function is performed successfully but the value of the parameters depends on the implementation (typically, you can either have 1/1/1970 at 0:00 or the returned change date).
Context
Windows client,
Windows server,
Adelia Cloud client,
Event Adelia client.
Parameters
ALPHA(n) |
File |
Name of the file to be tested. |
BOOL |
FileExists |
*TRUE if the file exists Output parameter. |
DATE |
CreationDate |
Local date that the file was created. Output parameter. |
TIME |
CreationTime |
Local time that the file was created. Output parameter. |
DATE |
ModifDate |
Local date that the file was modified. Output parameter. |
TIME |
ModifTime |
Local time that the file was modified. Output parameter. |
DATE |
AccessDate |
Local date that the file was accessed. Output parameter. |
TIME |
AccessTime |
Local time that the file was accessed. Output parameter. |
Example
ALPHA(256) = File
DATE = CreationDate
TIME = CreationTime
DATE = ModifDate
TIME = ModifTime
DATE = AccessDate
TIME = AccessTime
BOOL = FileExists
* Displays the date and time for the 'c:\temp\test.txt' file
File = 'c:\temp\test.txt'
CALL_DLL 'VaToolBx' 'VaToolBxGetFileTimeEx' File FileExists CreationDate CreationTime ModifDate ModifTime AccessDate AccessTime
IF NOT FileExists
* Error processing...
END
List of the VaToolBx functions by topic