JP1 Version 8 JP1/NETM/DM Automatic Installation Toolガイド (Windows(R)用)
機能
指定した属性でファイルが存在するかどうかを確認します。
形式
integer AIT_FileExists ( string strFileName // ファイル名 [,integer nFileAttributes] // ファイル属性 );
引数
strFileName(入力用)
検索するファイルの名前を指定してください。
nFileAttributes(入力用,省略可)
ファイルの属性を指定してください。これは,次の値のどれかにする必要があります。
| 値 | 意味 |
|---|---|
| FILE_ATTRIBUTE_DIRECTORY | ファイルはディレクトリです。 |
| FILE_ATTRIBUTE_HIDDEN | ファイルは隠しファイルです。 |
| FILE_ATTRIBUTE_SYSTEM | ファイルはOSの一部,またはOS専用です。 |
| FILE_ATTRIBUTE_ARCHIVE | ファイルはアーカイブファイルです。アプリケーションはこの属性を,ファイルのバックアップや削除のためのマークとして使います。 |
| FILE_ATTRIBUTE_READONLY | ファイルは読み取り専用です。アプリケーションはファイルを読み取れますが,書き込みや削除はできません。 |
省略した場合は,ファイル属性とは無関係にファイルが検出されます。
戻り値
ファイルが存在する場合,戻り値は1です。ファイルが存在しない場合,戻り値は0です。失敗した場合,戻り値は-1です。-1が返された場合は,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。
| 拡張エラー番号 | エラーコード |
|---|---|
| 2 | ERROR_FILE_NOT_FOUND |
| 3 | ERROR_PATH_NOT_FOUND |
| 5 | ERROR_ACCESS_DENIED |
| 6 | ERROR_INVALID_HANDLE |
| 8 | ERROR_NOT_ENOUGH_MEMORY |
| 14 | ERROR_OUTOFMEMORY |
| 15 | ERROR_INVALID_DRIVE |
| 21 | ERROR_NOT_READY |
| 53 | ERROR_BAD_NETPATH |
| 87 | ERROR_INVALID_PARAMETER |
| 112 | ERROR_DISK_FULL |
| 123 | ERROR_INVALID_NAME |
| 148 | ERROR_PATH_BUSY |
| 161 | ERROR_BAD_PATHNAME |
| 998 | ERROR_NOACCESS |
| 1005 | ERROR_UNRECOGNIZED_VOLUME |
| 1210 | ERROR_INVALID_COMPUTERNAME |
| 1214 | ERROR_INVALID_NETNAME |
| 1231 | ERROR_NETWORK_UNREACHABLE |
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.