PathRenameExtensionW 関数 (shlwapi.h)

  • [アーティクル]

ファイル名の拡張子を新しい拡張子に置き換えます。 ファイル名に拡張子が含まれていない場合は、文字列の末尾にこの拡張子が付けられます。

メモ この関数を誤用すると、バッファー オーバーランが発生する可能性があります。 その代わりに、より安全な PathCchRenameExtension 関数を 使用することをお勧めします。
 

構文

BOOL PathRenameExtensionW(
  [in, out] LPWSTR  pszPath,
  [in]      LPCWSTR pszExt
);

パラメーター

[in, out] pszPath

種類: LPTSTR

拡張を置き換える長さの null で終わる文字列へのポインター MAX_PATH。

[in] pszExt

型: LPCTSTR

'.' 文字の後に新しい拡張子が続く文字バッファーへのポインター。

戻り値

種類: BOOL

成功した場合は 0 以外、新しいパスと拡張子がMAX_PATH文字を超える場合は 0 を返します。

注釈

注意

shlwapi.h ヘッダーは PathRenameExtension をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlwapi.h
Library Shlwapi.lib
[DLL] Shlwapi.dll (バージョン 4.71 以降)