tf_set_file_timestamp(), sf_set_file_timestamp()

Purpose

Sets the last modification date and time of a file opened for writing

Syntax (CCOWN)

void tf_set_file_timestamp(int filenr, const datetype *date, const timetype *time);
void sf_set_file_timestamp(int filenr, const datetype *date, const timetype *time);

Syntax (DP4DBAPI)

BOOLEAN dp4_sf_set_file_timestamp(FCONN * fconn,const datetype * date,const timetype * time)

Parameters

int filenr

Handle to file, obtained by earlier call to tf_open() (or sf_open() for sf_ variant)

Parameters

FCONN * fconn

Handle to file, obtained by earlier call to dp4_sf_open()

 

const datetype* date

Pointer to a variable holding the derired last modification date

 

const timetype* time

Pointer to a variable holding the derired last modification time

Description

The tf_set_file_timestamp() and sf_set_file_timestamp() functions change the last modification date/time infomration for a file to the value specified in the parameters.

In order to successfully set the timestamp of a file you must close the file immediately after calling this function, or at least ensure that you do not write to the file again. If you write to the file again later on, the underlying operating system will change the last modification of the file.

See also

tf_get_file_timestamp()