OpenFile 関数 (winbase.h)

ファイルを作成、開く、再度開く、または削除します。

構文

HFILE OpenFile(
  [in]  LPCSTR     lpFileName,
  [out] LPOFSTRUCT lpReOpenBuff,
  [in]  UINT       uStyle
);

パラメーター

[in] lpFileName

ファイルの名前です。

文字列は、8 ビット Windows 文字セットの文字で構成されている必要があります。 OpenFile 関数では、Unicode ファイル名や名前付きパイプを開く機能はサポートされていません。

[out] lpReOpenBuff

最初に開いたときにファイルに関する情報を受け取る OFSTRUCT 構造体へのポインター。

この構造体は、 OpenFile 関数の後続の呼び出しで使用して、開いているファイルを確認できます。

OFSTRUCT 構造体には、長さが 128 文字のOFS_MAXPATHNAME文字に制限されたパス文字列メンバーが含まれています。 このため、 OpenFile 関数を使用して、パスの長さが 128 文字を超えるファイルを開くことはできません。 CreateFile 関数には、このパスの長さの制限はありません。

[in] uStyle

実行するアクション。

このパラメーターには、次の 1 つ以上の値を指定できます。

戻り値

関数が成功した場合、戻り値はファイル I/O の実行時に使用するファイル ハンドルを指定します。 ファイルを閉じるには、このハンドルを使用して CloseHandle 関数を呼び出します。

関数が失敗した場合、戻り値は HFILE_ERROR。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

lpFileName パラメーターでファイル名と拡張子のみが指定されている場合、この関数は次のディレクトリと表示される順序で一致するファイルを検索します。

1. アプリケーションが読み込まれるディレクトリ。
2. 現在のフォルダー。
3. Windows システム ディレクトリ。

   GetSystemDirectory 関数を使用して、このディレクトリのパスを取得します。

4. 16 ビット Windows システム ディレクトリ。

   このディレクトリのパスを取得する関数はありませんが、検索されます。

5. Windows ディレクトリ。

   GetWindowsDirectory 関数を使用して、このディレクトリのパスを取得します。

6. PATH 環境変数に一覧表示されているディレクトリ。

OpenFile 関数は、16 ビット Windows OpenFile 関数がサポートするOF_SEARCH フラグをサポートしていません。 OF_SEARCH フラグは、ファイル名に完全パスが含まれている場合でも、一致するファイルを検索するようにシステムに指示します。 SearchPath 関数を使用してファイルを検索します。

共有違反は、 uStyle パラメーターの値が他のアクセス フラグを持つ OF_DELETE アクセス フラグ OR'ed であり、リモート ファイルまたはディレクトリが共有アクセスで開かされていない場合に、リモート コンピューターでファイルまたはディレクトリを開こうとした 場合FILE_SHARE_DELETE 発生します。 このシナリオで共有違反を回避するには、 OF_DELETE アクセス権のみを持つリモート ファイルまたはディレクトリを開くか、削除のために最初にファイルまたはディレクトリを開かずに DeleteFile を呼び出します。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

CsvFs によって、圧縮されたファイルのリダイレクトされた IO が実行されます。

要件

関連項目

CreateFile

File Management 関数

GetSystemDirectory

GetWindowsDirectory

OFSTRUCT

SearchPath