GetFileAttributesExW

指定したファイルまたはディレクトリの属性を取得する。(Unicode)

GetFileAttributesExW lpFileName, fInfoLevelId, lpFileInformation

lpFileName : [wstr] ファイルまたはディレクトリの名前。本関数の ANSI 版では名前は MAX_PATH 文字に制限される。この制限を 32,767 ワイド文字に拡張するには、Unicode 版 (GetFileAttributesExW) を呼び、パスの先頭に "\\?\" を付加する。詳細は Naming a File を参照。ヒント: Windows 10 バージョン 1607 以降、Unicode 版 (GetFileAttributesExW) では "\\?\" を付加せずに MAX_PATH 文字制限を解除するオプトインが可能。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Limitation" 節を参照。
fInfoLevelId : [int] 取得する属性情報のクラス。本パラメータは GET_FILEEX_INFO_LEVELS 列挙体の以下の値を指定できる。
lpFileInformation : [intptr] 属性情報を受け取るバッファへのポインタ。このバッファに格納される属性情報の型は fInfoLevelId の値で決まる。

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

解説

指定したファイルまたはディレクトリの属性を取得する。(Unicode)

[戻り値]
関数が成功した場合の戻り値は 0 以外である。失敗した場合の戻り値は 0 である。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
GetFileAttributes 関数はファイルシステム属性情報を取得する。GetFileAttributesEx
は他のセットのファイルまたはディレクトリの属性情報を取得できる。現時点では GetFileAttributesEx
は、ファイルシステム属性情報のスーパーセットである標準属性のセットを取得する。マウントフォルダであるディレクトリに対して
GetFileAttributesEx
を呼び出した場合、そのディレクトリの属性を返し、マウントフォルダが関連付けられているボリュームのルートディレクトリの属性は返さない。関連付けられたボリュームの属性を取得するには、GetVolumeNameForVolumeMountPoint
を呼んで関連ボリュームの名前を取得し、その名前を使って GetFileAttributesEx
を呼ぶ。結果は関連ボリュームのルートディレクトリの属性となる。Windows 8 および Windows Server 2012
では、本関数は以下の技術によりサポートされている。
（以下省略）

情報