System.SysUtils.FileOpen

• 親: System.SysUtils

Delphi

function FileOpen(const FileName: string; Mode: LongWord): THandle;

C++

extern DELPHI_PACKAGE Winapi::Windows::THandle __fastcall FileOpen(const System::UnicodeString FileName, System::LongWord Mode);

プロパティ

種類	可視性	ソース	ユニット	親
function	public	System.SysUtils.pas System.SysUtils.hpp	System.SysUtils	System.SysUtils

説明

FileOpen指定のファイルを指定のアクセス モードで開きます。

FileOpen を使用してファイルを開き、ファイル ハンドルを取得します。Mode パラメータは、ファイルを開く方法を示します。 Mode パラメータは、オープン モードと（可能な場合の）共有モードを表す識別子を or で結んで指定します。

オープン モード定数には、次の値のいずれかを使用します：

値	意味
fmExclusive	ファイルを存在しない場合にのみ、自動的に作成し、そうでなければ失敗します。
fmOpenRead	読み取り専用でファイルを開きます。
fmOpenWrite	書き込み専用でファイルを開きます。 ファイルへの書き込みにより、現在の内容は完全に置き換えられます。
fmOpenReadWrite	ファイルを開き、現在の内容を置き換えるのではなく、変更する。

共有モード定数には、次の値のいずれかを使用します：

値	意味
fmShareCompat	共有は、FCB が開かれる方法と互換性がある。
fmShareExclusive	他のアプリケーションは、いかなる理由でもファイルを開くことはできない。
fmShareDenyWrite	他のアプリケーションは、ファイルを読み取り用に開くことはできるが、書き込み用に開くことはできない。
fmShareDenyRead	他のアプリケーションは、書き込みのためにはファイルを開けるが、読み取りのためにはできない。
fmShareDenyNone	他のアプリケーションによるファイルの読み取りおよび書き込みを回避する処理は行われない。

FileOpen は次を返します：

• INVALID_HANDLE_VALUE とは異なる値。この場合、関数が成功し、その値が開かれたファイルのファイル ハンドルであることを意味します。
• INVALID_HANDLE_VALUE に等しい値。エラーが発生したことを示します。

メモ: FileOpen などの非ネイティブ Delphi 言語ファイル ハンドラの使用はお勧めしません。これらのルーチンはシステム ルーチンにマップされ、OS ファイル ハンドルを返します（通常の Delphi ファイル変数ではない）。これらは低レベルのファイル アクセス ルーチンです。通常のファイル操作では、AssignFile、Rewrite、および Reset を代わりに使用します。

関連項目

• FileClose
• FileCreate
• AssignFile
• Rewrite
• Reset
• ファイル入出力のサポート

コード サンプル

• FileListBox (Delphi)
• FileOpen (C++)
• FileOpen (Delphi)
• FileRead (Delphi)
• FileToGrid (C++)
• FileToGrid (Delphi)
• SysUtilsFileOpen (C++)