Rubrique précédente: SetFileAttributes – Définir les attributs des fichiersRubrique suivante: Fonctions d'icône


SetFileTime : Définir des horodateurs pour un fichier ou un répertoire

Valide sur les plates-formes NetWare, Symbian OS, UNIX, Windows et Windows CE

La fonction SetFileTime définit les horodateurs d'un fichier ou d'un répertoire.

Cette fonction de contenu de fichier présente le format suivant :

SetFileTime(fileName as string, dateAndTime as DateTime, Type as integer) as Boolean
SetFileTime(fileName as string, dateAndTime as DateTime) as Boolean
fileName

Indique le nom du fichier dont la date et l'heure doivent être modifiées.

dateAndTime

Identifie les nouvelles date et heure à définir.

Type

Valeur 0 : la date et l'heure de création seront modifiées (par défaut).

Valeur 1 : la date et l'heure du dernier accès au fichier seront modifiées.

Valeur 2 : la date et l'heure de la dernière modification du fichier seront modifiées.

Valeur 3 : la date et l'heure de la création, du dernier accès et de la dernière écriture seront modifiées.

En cas de réussite, la fonction renvoie True, sinon elle renvoie False.

Exemple : Fonction SetFileTime

Rem Modifiez l'heure d'écriture
Dim newTime as DateTime
newTime.year = 1999
newTime.month = 12
newTime.day = 31
newTime.hour = 23
newTime.minute = 59
newTime.second = 59
If Not(SetFileTime("c:\autoexec.bat",newTime,2)) Then
	Print ("Echec de SetFileTime")
	quitter
End If

Lecture et comparaison des versions de fichier

Vous pouvez lire et comparer les informations sur la version d'un fichier à l'aide des fonctions DMScript. Par exemple, vous pouvez lire et comparer la version du fichier dmscript.exe pour vérifier si le script s'exécute sur la version désirée de DMScript.

GetFileInfo

La fonction GetFileInfo lit les informations relatives à un fichier donné. Vous pouvez utiliser les informations de fichier récupérées avec d'autres fonctions telles que CompareVersions.

Cette fonction présente le format suivant :

GetFileInfo (option as string, filename as string, result as string) as boolean

Exemple : GetFileInfo

getfileinfo("version","dmscript.exe",version)

Paramètres d'entrée

Cette fonction présente les paramètres d'entrée suivants :

Option

Spécifie les informations de fichier que vous voulez récupérer. Vous pouvez choisir l'une des options suivantes :

"version"

Récupère la chaîne de version de fichier complète au format major.minor.patch.build. Exemple: "12.5.0.1234"

"major"

Récupère le numéro de version majeure du fichier.

"minor"

Récupère le numéro de version mineure du fichier.

"patch"

Récupère le numéro de patch du fichier.

"build"

Récupère le numéro de compilation du fichier.

"desc"

Récupère la description de fichier (Windows uniquement).

"ext"

Récupère l'extension du fichier.

"filename"

Récupère le nom de fichier à partir d'un chemin d'accès sans l'extension.

Result

Spécifie une variable de chaîne qui contient le résultat renvoyé par la fonction.

Valeurs de retour

Si la fonction permet de récupérer les informations sur le fichier, elle renvoie true.

CompareVersions

La fonction CompareVersions compare deux versions de fichier et indique si elles sont identiques. Cette fonction présente le format suivant :

CompareVersions (version1 as string, version2 as string) as integer

Exemple : CompareVersions

CompareVersions ("12.5.1.4", "12.5.0.3")

Paramètres d'entrée

Cette fonction présente les paramètres d'entrée suivants :

version1 et version2

Spécifie les versions du fichier que vous voulez comparer. Dans la chaîne de version, vous pouvez spécifier autant d'éléments d'identification de version que vous le souhaitez. Par exemple, vous pouvez spécifier la chaîne de version à l'aide du format major.minor.patch.build ou simplement major.minor. Les numéros de version peuvent être séparés par des points, des espaces ou des virgules. Si une chaîne de version compte plus d'éléments d'identification que l'autre, les éléments manquants sont remplacés par des zéros au moment de la comparaison. Par exemple, CompareVersions ("12.5.180.123", "12.5") est considéré comme CompareVersions ("12.5.180.123", "12.5.0.0").

Valeurs de retour

La fonction renvoie l'une des constantes de nombre entier prédéfinies suivantes :

ECVEQUAL (0)

Indique que les versions sont égales.

ECVGREATERTHAN (1)

Indique que la version 1 est supérieure à la version 2.

ECVLESSTHAN (-1)

Indique que la version 1 est inférieure à la version 2.

ECVINVALID (2)

Indique que l'une des chaînes de version ou que les deux sont vides ou contiennent une valeur non chiffrée.