GetFileInformationByHandle

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

GetFileInformationByHandle hFile, lpFileInformation

hFile : [intptr] 取得する情報を含むファイルへのハンドル。このハンドルはパイプハンドルであってはならない。
lpFileInformation : [var] ファイル情報を受け取る BY_HANDLE_FILE_INFORMATION 構造体へのポインタ。

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

解説

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

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

[備考]
オペレーティングシステムの基盤となるネットワーク機能や接続先サーバーの種類によっては、GetFileInformationByHandle
関数は失敗したり、部分的または完全な情報を返したりすることがある。BY_HANDLE_FILE_INFORMATION 構造体で返される
VolumeSerialNumber と FileIndex メンバを比較すれば、2 つのパスが同じ対象を指しているかを判定できる。例えば
2 つのファイルパスが同じディレクトリを指しているかを判定できる。Windows 8 および Windows Server 2012
では、本関数は以下の技術によりサポートされている。
（以下省略）

情報