表示: Delphi
C++
表示設定
System.SysUtils.FileCreate
提供：XE2 API Documentation
Delphi
function FileCreate(const FileName: string): THandle; function FileCreate(const FileName: string; Rights: Integer): THandle; function FileCreate(const FileName: string; Mode: LongWord; Rights: Integer): THandle;
C++
extern PACKAGE unsigned __fastcall FileCreate(const System::UnicodeString FileName)/* overload */;
目次 |
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | System.SysUtils.pas System.SysUtils.hpp |
System.SysUtils | System.SysUtils |
説明
新しいファイルを作成します。
FileCreate は、指定された名前で新しいファイルを作成します。戻り値が正であれば、関数は正常に終了していて、その値は新しいファイルのファイル ハンドルになっています。戻り値が INVALID_HANDLE_VALUE であれば、エラーが発生したことを示します。
FileCreate の戻り値は、Int から THandle に変更されました。以前の動作を維持するには、FileCreate の戻り値を System.NativeInt にキャストします。この場合、戻り値 -1 がエラーを表します。次のコードでは、そのやり方の例を示しています。
var
MyFile: NativeInt;
begin
MyFile := NativeInt(FileCreate('C:\temp\bla.txt'));
if MyFile = -1 then
raise Exception.Create('File already exists');
end:
メモ： Windows ではFileAccessRights変数とRightsパラメータが無視されます。