GetFileInformationByHandleEx

指定したファイルのファイル情報を取得する。(GetFileInformationByHandleEx)

GetFileInformationByHandleEx hFile, FileInformationClass, lpFileInformation, dwBufferSize

hFile : [intptr] 取得する情報を含むファイルへのハンドル。このハンドルはパイプハンドルであってはならない。
FileInformationClass : [int] 取得する情報の種別を指定する FILE_INFO_BY_HANDLE_CLASS 列挙値。有効な値の一覧は注釈を参照。
lpFileInformation : [intptr] 要求したファイル情報を受け取るバッファへのポインタ。返される構造体は FileInformationClass で指定したクラスに対応する。有効な構造体型の表は注釈を参照。
dwBufferSize : [int] lpFileInformation バッファのサイズ（バイト単位）。

(プラグイン / モジュール : kernel32.dll)

解説

指定したファイルのファイル情報を取得する。(GetFileInformationByHandleEx)

[戻り値]
関数が成功した場合の戻り値は 0 以外であり、ファイル情報データは lpFileInformation
が指すバッファに格納される。失敗した場合の戻り値は 0 である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
FileInformationClass が FileStreamInfo
で、呼び出しは成功したがストリームが返されなかった場合、GetLastError が返すエラーは ERROR_HANDLE_EOF
となる。一部のファイル情報クラスは、オペレーティングシステムのリリースによって挙動がわずかに異なる。これらのクラスは下位ドライバによってサポートされており、返される情報は
OS リリースごとに変わり得る。本関数で使用可能なファイル情報クラス型と対応データ構造体型を以下の表に示す。
（以下省略）

情報