GetShortPathNameW

指定したパスの短いパス形式を取得する。(GetShortPathNameW)

GetShortPathNameW lpszLongPath, lpszShortPath, cchBuffer

lpszLongPath : [wstr] パス文字列。この関数の ANSI 版では、名前は MAX_PATH 文字に制限される。この制限を 32,767 ワイド文字に拡張するには、関数の Unicode 版を呼び出してパスの先頭に "\\\\?\\" を付加する。詳細は Naming Files, Paths, and Namespaces を参照。
lpszShortPath : [wstr] lpszLongPath が指定するパスの null 終端短縮形式を受け取るバッファへのポインタ。このパラメータに NULL を渡し、cchBuffer に 0 を渡すと、指定された lpszLongPath に必要なバッファサイズが常に返される。
cchBuffer : [int] lpszShortPath が指すバッファのサイズ（TCHAR 単位）。lpszShortPath が NULL に設定されている場合、このパラメータを 0 に設定する。

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

解説

指定したパスの短いパス形式を取得する。(GetShortPathNameW)

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

[備考]
lpszLongPath パラメータが指定するパスはフルパスや長いパスである必要はない。短縮形式は指定パスより長くなる場合がある。戻り値が
cchBuffer
パラメータで指定された値より大きい場合、パスを保持するのに十分な大きさのバッファで関数を再度呼び出すことができる。動的確保のために長さ 0
のバッファを使用するこの場合の例については、サンプルコードセクションを参照。注意 この場合の戻り値は終端 null
文字を含む長さであるが、成功時の戻り値はカウントに終端 null
文字を含まない。指定されたパスが既に短縮形式で変換が不要な場合、関数は単に指定パスを lpszShortPath
パラメータで指定されたバッファにコピーする。lpszShortPath パラメータを lpszLongPath
パラメータと同じ値に設定できる。つまり、短縮パスの出力バッファを入力パス文字列のアドレスに設定できる。cchBuffer
パラメータが常にこのバッファの合計サイズ（TCHAR 単位）を正確に表すようにする。GetLongPathName
関数を呼び出すことで、短い名前からファイルの長い名前を取得できる。あるいは、GetLongPathName
が利用できない場合、パスの各コンポーネントに対して FindFirstFile
を呼び出して対応する長い名前を取得できる。ファイルやディレクトリへのアクセス権はあるが、そのファイルやディレクトリの親ディレクトリの一部にアクセス権がない場合がある。その結果、パスコンポーネントの親ディレクトリをクエリしてそのコンポーネントの短縮名を判別できない場合、GetShortPathName
は失敗する可能性がある。このチェックは、すでに短縮名の要件を満たすディレクトリコンポーネントについてはスキップ可能である。詳細は
Naming Files, Paths, and Namespaces の Short vs. Long Names
セクションを参照。Windows 8 および Windows Server 2012 では、この関数は以下の技術によりサポートされる。
（以下省略）

情報