Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter SixFile Functions (continued)

SetFileTime Function

Overview

The SetFileTime function sets the creation and modified time for Basic File Object or simple target filename.

Syntax/Parameters

Syntax

int = SetFileTime ( handle hBasicFile | string name, string | qword create,
                                                [string | qword modified] );

Parameters

hBasicFile

A handle to a Basic File Object. Or,

name

A string containing the name of the target file. This parameter supports UTF encoding for filenames with Unicode characters.

create

A qword in file time format or a string in ISO-8601 format specifying the creation time for the file in UTC.

modified

An optional qword in file time format or a string in ISO-8601 format specifying the modified time for the file in UTC. If omitted, the creation time is used.

Return Value

Returns an int as ERROR_NONE or a formatted error code on failure. When supplying strings for time values, ERROR_SYNTAX with the parameter number will be returned if the date/time contains a formatting error.

Remarks

The supported resolution of the file times depends on the file system.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic