GetFullPathNameTransactedW

指定したファイルのフルパスとファイル名をトランザクション操作として取得する。(Unicode)

GetFullPathNameTransactedW lpFileName, nBufferLength, lpBuffer, lpFilePart, hTransaction

lpFileName : [wstr] ファイルの名前。この文字列は短いファイル名 (8.3 形式) または長いファイル名のいずれも使用できる。共有名やボリューム名でもよい。ファイルはローカルコンピュータ上に存在しなければならない。そうでない場合、関数は失敗し、直近エラーコードに ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE が設定される。
nBufferLength : [int] ドライブとパスの null 終端文字列を受け取るバッファのサイズ（TCHAR 単位）。
lpBuffer : [wstr] ドライブとパスの null 終端文字列を受け取るバッファへのポインタ。
lpFilePart : [var] パスの末尾のファイル名コンポーネントのアドレス（lpBuffer 内）を受け取るバッファへのポインタ。この情報を必要としない場合は NULL を指定する。lpBuffer がファイルではなくディレクトリを指す場合、lpFilePart は 0 を受け取る。
hTransaction : [intptr] トランザクションへのハンドル。このハンドルは CreateTransaction 関数によって返される。

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

解説

指定したファイルのフルパスとファイル名をトランザクション操作として取得する。(Unicode)

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

[備考]
GetFullPathNameTransacted
は現在のドライブとディレクトリの名前を、指定したファイル名と組み合わせて、指定したファイルのフルパスとファイル名を求める。また、フルパスとファイル名の中のファイル名部分のアドレスも算出する。本関数は、結果のパスとファイル名が有効かどうか、または関連ボリューム上に既存のファイルが見えるかどうかは検証しない。共有名とボリューム名は
lpFileName の有効な入力である。例えば test-2 がリモートコンピュータで U:
がネットワークマップドライブの場合、返されるパスとファイル名は次のとおりである。
（以下省略）

情報