AIT_FileOpen
機能
既存のファイルを開きます。または、指定したアクセスモードで新規ファイルを作成します。
形式
bool AIT_FileOpen ( string strFileName, // ファイル名 integer nAccessMode, // アクセスモード integer nOperation, // 作成方法 integer nFileHandle // ファイルハンドル );
引数
strFileName（入力用）
作成するファイルまたは開くファイルの名前を指定してください。
nAccessMode（入力用）
ファイルへのアクセスモードを指定してください。これは、次の値のどれかまたは両方の組み合わせです。
|
値 |
意味 |
|---|---|
|
GENERIC_READ |
ファイルへの読み取りアクセスを指定します。ファイルからのデータの読み取りとファイルポインタの移動ができます。読み取り/書き込みアクセスを指定するには、GENERIC_WRITEと組み合わせてください。 |
|
GENERIC_WRITE |
ファイルへの書き込みアクセスを指定します。ファイルへのデータの書き込みとファイルポインタの移動ができます。読み取り/書き込みアクセスを指定するには、GENERIC_READと組み合わせてください。 |
nOperation（入力用）
ファイルが存在する場合、または存在しない場合のファイルの扱い方を指定します。次の値のどれかにする必要があります。
|
値 |
意味 |
|---|---|
|
CREATE_NEW |
新規ファイルを作成します。指定したファイルがすでに存在する場合、関数は失敗します。 |
|
CREATE_ALWAYS |
新規ファイルを作成します。指定したファイルがすでに存在する場合、関数はそのファイルを上書きします。 |
|
OPEN_EXISTING |
ファイルを開きます。ファイルが存在しない場合、関数は失敗します。 |
|
OPEN_ALWAYS |
ファイルが存在する場合は、それを開きます。ファイルが存在しない場合は、そのファイルが作成されます。 |
|
TRUNCATE_EXISTING |
ファイルを開きます。開かれたファイルは、サイズが0バイトになるように切り捨てられます。呼び出しプロセスで、少なくともGENERIC_WRITEアクセスを指定してファイルを開く必要があります。ファイルが存在しない場合、関数は失敗します。 |
nFileHandle（出力用）
ファイルハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にファイルハンドルが格納されます。
戻り値
この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。
|
拡張エラー番号 |
エラーコード |
|---|---|
|
2 |
ERROR_FILE_NOT_FOUND |
|
3 |
ERROR_PATH_NOT_FOUND |
|
4 |
ERROR_TOO_MANY_OPEN_FILES |
|
5 |
ERROR_ACCESS_DENIED |
|
6 |
ERROR_INVALID_HANDLE |
|
8 |
ERROR_NOT_ENOUGH_MEMORY |
|
14 |
ERROR_OUTOFMEMORY |
|
15 |
ERROR_INVALID_DRIVE |
|
18 |
ERROR_NO_MORE_FILES |
|
19 |
ERROR_WRITE_PROTECT |
|
21 |
ERROR_NOT_READY |
|
32 |
ERROR_SHARING_VIOLATION |
|
33 |
ERROR_LOCK_VIOLATION |
|
53 |
ERROR_BAD_NETPATH |
|
80 |
ERROR_FILE_EXISTS |
|
82 |
ERROR_CANNOT_MAKE |
|
87 |
ERROR_INVALID_PARAMETER |
|
112 |
ERROR_DISK_FULL |
|
123 |
ERROR_INVALID_NAME |
|
148 |
ERROR_PATH_BUSY |
|
161 |
ERROR_BAD_PATHNAME |
|
183 |
ERROR_ALREADY_EXISTS |
|
206 |
ERROR_FILENAME_EXCED_RANGE |
|
1005 |
ERROR_UNRECOGNIZED_VOLUME |
|
1210 |
ERROR_INVALID_COMPUTERNAME |
|
1214 |
ERROR_INVALID_NETNAME |
|
1231 |
ERROR_NETWORK_UNREACHABLE |
|
1392 |
ERROR_FILE_CORRUPT |
注意事項
AIT_OpenFileが返したファイルハンドルを閉じるには、AIT_FileClose関数を使用してください。