PathRenameExtension(A)

パスを表す文字列の拡張子を新しい拡張子に置き換えます。元のパスに拡張子が含まれていない場合は、拡張子を付け加えます。

BOOL PathRenameExtensionA(
    PTSTR  pszPath,      // 元のパス名
    PCTSTR pszExtension  // 拡張子
);

SHLWAPI.DLL

引数

pszPath

拡張子を置き換えるためのパスを表す 260 (MAX_PATH) バイト（Unicode 版の場合は 260 (MAX_PATH) 文字）以下の文字列を格納したバッファのアドレスを指定します。

pszExtension

付け加えるファイル拡張子を表す文字列のアドレスを指定します。拡張子にはピリオドをつけておきます。

戻り値

成功すると 0 以外の値が返ります。

拡張子を置き換えた後の文字列が 260 (MAX_PATH) バイト（Unicode 版の場合は 260 (MAX_PATH) 文字）を超える場合は、 0 が返ります。

対応情報

Shlwapi.dll Version 4.71 以降

Windows 98 以降 / Windows 2000 以降

または Internet Explorer 4.0 以降をインストールした Windows 95 / Windows NT 4.0