PathRenameExtensionW 関数 (shlwapi.h)
ファイル名の拡張子を新しい拡張子に置き換えます。 ファイル名に拡張子が含まれていない場合、拡張子は文字列の末尾に添付されます。
この関数の誤用 バッファー オーバーランにつながる可能性があることに注意してください。 PathCchRenameExtension 関数の代わりに、より安全な を使用することをお勧めします。
構文
BOOL PathRenameExtensionW(
[in, out] LPWSTR pszPath,
[in] LPCWSTR pszExt
);
パラメーター
[in, out] pszPath
型: LPTSTR
拡張機能を置き換える長MAX_PATHの null で終わる文字列へのポインター。
[in] pszExt
型: LPCTSTR
'.' 文字の後に新しい拡張子が続く文字バッファーへのポインター。
戻り値
型: BOOL
成功した場合は 0 以外、新しいパスと拡張子がMAX_PATH文字を超える場合は 0 を返します。
備考
手記
shlwapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PathRenameExtension を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | shlwapi.h |
ライブラリ | Shlwapi.lib |
DLL | Shlwapi.dll (バージョン 4.71 以降) |