GetLongPathNameTransactedW

指定したパスをトランザクション操作として長い形式に変換する。(Unicode)

GetLongPathNameTransactedW lpszShortPath, lpszLongPath, cchBuffer, hTransaction

lpszShortPath : [wstr] 変換するパス。本関数の ANSI 版では名前は MAX_PATH (260) 文字に制限される。この制限を 32,767 ワイド文字に拡張するには、Unicode 版を呼び、パスの先頭に "\\?\" を付加する。詳細は Naming Files, Paths, and Namespaces を参照。パスはローカルコンピュータ上に存在しなければならない。そうでない場合、関数は失敗し、直近エラーコードに ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE が設定される。
lpszLongPath : [wstr] 長いパスを受け取るバッファへのポインタ。lpszShortPath パラメータに使用したものと同じバッファを使用できる。
cchBuffer : [int] lpszLongPath が指すバッファのサイズ（TCHAR 単位）。
hTransaction : [intptr] トランザクションへのハンドル。このハンドルは CreateTransaction 関数によって返される。

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

解説

指定したパスをトランザクション操作として長い形式に変換する。(Unicode)

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

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

情報