GetLongPathNameW

指定したパスを長い形式に変換する。(Unicode)

GetLongPathNameW lpszShortPath, lpszLongPath, cchBuffer

lpszShortPath : [wstr] 変換するパス。本関数の ANSI 版 GetLongPathNameA では名前は MAX_PATH (260) 文字に制限される。この制限を 32,767 ワイド文字に拡張するには、Unicode 版 GetLongPathNameW を呼び、パスの先頭に "\\?\" を付加する。詳細は Naming Files, Paths, and Namespaces を参照。ヒント: Windows 10 バージョン 1607 以降、Unicode 版 (GetLongPathNameW) では "\\?\" を付加せずに MAX_PATH 制限を解除するオプトインが可能。詳細は Naming Files, Paths, and Namespaces の "Maximum Path Length Limitation" 節を参照。
lpszLongPath : [wstr] 長いパスを受け取るバッファへのポインタ。lpszShortPath パラメータに使用したものと同じバッファを使用できる。
cchBuffer : [int] lpszLongPath が指すバッファのサイズ（TCHAR 単位）。

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

解説

指定したパスを長い形式に変換する。(Unicode)

[戻り値]
関数が成功した場合の戻り値は、終端 null 文字を含まずに lpszLongPath にコピーされた文字列の長さ（TCHAR
単位）である。lpBuffer バッファがパスを保持するには小さすぎる場合、戻り値はパスと終端 null
文字を保持するために必要なバッファのサイズ（TCHAR 単位）である。ファイルが存在しないなど、それ以外の理由で失敗した場合の戻り値は 0
である。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
多くのファイルシステムでは、短いファイル名にチルダ (~)
文字が含まれる。しかしすべてのファイルシステムがこの慣例に従うわけではない。したがって、パスにチルダ (~) 文字が含まれない場合でも
GetLongPathName
の呼び出しを省けると仮定してはならない。ファイルまたはディレクトリは存在するが長いパスが見つからない場合、GetLongPathName
は成功し、lpszShortPath パラメータが参照する文字列を lpszLongPath
パラメータが参照するバッファにコピーする。戻り値が cchBuffer
で指定された値より大きい場合、パスを保持するのに十分な大きさのバッファで関数を再度呼び出すことができる。この場合の例は
GetFullPathName のサンプルコード節を参照。注: この場合の戻り値は終端 null
文字を含む長さだが、成功時の戻り値はカウントに終端 null
文字を含めない。ファイルやディレクトリへのアクセス権はあるが、その親ディレクトリの一部にはアクセス権がないこともあり得る。その結果、GetLongPathName
は、パス構成要素の長い名前を判定するためにその親ディレクトリにクエリできない場合に失敗する可能性がある。3
文字より長い拡張子を持つディレクトリ構成要素や、合計長 12 文字を超えるディレクトリ構成要素については、このチェックを省略できる。詳細は
Naming Files, Paths, and Namespaces の Short vs. Long Names
節を参照。Windows 8 および Windows Server 2012 では、本関数は以下の技術によりサポートされている。
（以下省略）

情報