File Maintenance Functions

PxIOSetFileTime

Description

Sets one of the timestamps of an open file

Note:
Setting FILE_TIME_TYPE_CREATION_TIME on "Unix-like" systems is currently not supported.

Format

int PxIOSetFileTime(PxIOFileHandle handle, const int64_t timestamp, PxIOFileTimeType fileTimeType);

Where:

handle	The handle of an open file
timestamp	An int64_t value containing the new timestamp in POSIX time format
fileTimeType	The specific timestamp to set. See Appendix F for a list of currently allowed timestamps.

Return Value

If the function succeeds, a value of PXIO_SUCCESS_STATUS is returned; otherwise, an error value is returned. More information on the nature of the error can be found by calling PxIOGetError.

Note:
POSIX time format is a standard that is defined as the number of seconds since 00:00:00, January 1^st, 1970, Coordinated Universal Time (UTC). Coordinated Universal Time is roughly equivalent to Greenwich Mean Time. This standard is widely used in many "Unix-like" systems.