前のトピック: SetFileAttributes - ファイル属性の設定次のトピック: アイコン関数


SetFileTime - ファイルまたはディレクトリのタイムスタンプ設定

NetWare、Symbian OS、UNIX、Windows、および Windows CE で有効です。

SetFileTime 関数では、ファイルまたはディレクトリのタイムスタンプが設定されます。

ファイルの内容に関するこの関数の形式は、以下のとおりです。

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

日時を変更するファイルの名前を指定します。

dateAndTime

新しく設定する日時を指定します。

値 0: 作成日時が変更されます(デフォルト)。

値 1: ファイルへの最終アクセス日時が変更されます。

値 2: ファイルが最後に変更された日時が変更されます。

値 3: 作成日時、最終アクセス日時、および最終書き込み日時が変更されます。

この関数が正常に完了すると、TRUE が返されます。それ以外の場合は、FALSE が返されます。

例: SetFileTime 関数

Rem modify write time
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 ("SetFileTime failed")
	終了
End If

ファイル バージョンの読み取りと比較

DMScript 関数を使用して、任意のファイルのバージョン情報を読み取って比較できます。 たとえば、dmscript.exe のバージョンを読み取って比較し、スクリプトが適切な DMScript のバージョン上で実行されているかどうかを確認できます。

GetFileInfo

GetFileInfo 関数は、指定されたファイルのファイル情報を読み取ります。 CompareVersions など、取得されたファイル情報を別の関数で使用できます。

この関数の形式は、以下のとおりです。

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

例: GetFileInfo

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

入力パラメータ

この関数には、以下の入力パラメータがあります。

option

取得するファイル情報を指定します。 以下のいずれかのオプションを指定できます。

"version"

完全なファイル バージョン文字列を、major.minor.patch.build 形式で取得します。 例: "12.5.0.1234"

"major"

ファイルのメジャー バージョン番号を取得します。

"minor"

ファイルのマイナー バージョン番号を取得します。

"patch"

ファイルのパッチ番号を取得します。

"build"

ファイルのビルド番号を取得します。

"desc"

ファイル記述(Windows のみ)を取得します。

"ext"

ファイル拡張子を取得します。

"filename"

拡張子のないパス名からファイル名を取得します。

result

関数によって返される結果を保持する文字列変数を指定します。

戻り値

関数は、ファイル情報を取得できる場合には true を返します。

CompareVersions

CompareVersions 関数は 2 つのファイルのバージョンを比較し、それらが同一かどうかを返します。 この関数の形式は、以下のとおりです。

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

例: CompareVersions

CompareVersions ("12.5.1.4", "12.5.0.3")

入力パラメータ

この関数には、以下の入力パラメータがあります。

version1 と version2

比較するファイルのバージョンを指定します。 バージョン文字列に、任意の数のバージョン識別項目を指定できます。 たとえば、major.minor.patch.build 形式または単に major.minor 形式を使用して、バージョン文字列を指定できます。 バージョン番号は、ドット、スペース、またはカンマによって分離できます。 1 つのバージョン文字列に別のバージョン文字列より多くの識別項目が存在する場合、存在しない項目は比較時にゼロで置換されます。 たとえば、CompareVersions ("12.5.180.123", "12.5") は CompareVersions ("12.5.180.123", "12.5.0.0") として扱われます。

戻り値

この関数は、以下のいずれかの事前定義済み整数定数を返します。

ECVEQUAL(0)

バージョンが等しいことを示します。

ECVGREATERTHAN(1)

バージョン 1 がバージョン 2 より大きいことを示します。

ECVLESSTHAN(-1)

バージョン 1 がバージョン 2 より小さいことを示します。

ECVINVALID(2)

1 つまたは両方のバージョン文字列がブランクか、または非数値の値が含まれていることを示します。