AIT_FileRename

機能

ファイルまたはディレクトリの名前を変更します。

形式

bool AIT_FileRename (
 string strFileName,       // 現在のファイル名
 string strNewFileName     // 新しいファイル名
);

引数

strFileName(入力用)

名前を変更するファイルまたはディレクトリの名前を指定してください。

strNewFileName(入力用)

ファイルまたはディレクトリの新しい名前を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue,そのほかの場合はfalseとなります。関数がfalseを返した場合には,AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返す可能性のあるエラーコードを次に示します。

拡張エラー番号エラーコード
2ERROR_FILE_NOT_FOUND
3ERROR_PATH_NOT_FOUND
5ERROR_ACCESS_DENIED
6ERROR_INVALID_HANDLE
8ERROR_NOT_ENOUGH_MEMORY
14ERROR_OUTOFMEMORY
15ERROR_INVALID_DRIVE
19ERROR_WRITE_PROTECT
21ERROR_NOT_READY
38ERROR_HANDLE_EOF
53ERROR_BAD_NETPATH
80ERROR_FILE_EXISTS
82ERROR_CANNOT_MAKE
87ERROR_INVALID_PARAMETER
123ERROR_INVALID_NAME
148ERROR_PATH_BUSY
161ERROR_BAD_PATHNAME
1005ERROR_UNRECOGNIZED_VOLUME
1210ERROR_INVALID_COMPUTERNAME
1214ERROR_INVALID_NETNAME
1231ERROR_NETWORK_UNREACHABLE