Функция PathRenameExtensionA (shlwapi.h)

Статья
11/20/2024

Заменяет расширение имени файла новым расширением. Если имя файла не содержит расширения, расширение будет присоединено к концу строки.

примечание Неправильное использование этой функции может привести к переполнению буфера. Мы рекомендуем использовать более безопасную функцию PathCchRenameExtension на своем месте.

Синтаксис

BOOL PathRenameExtensionA(
  [in, out] LPSTR  pszPath,
  [in]      LPCSTR pszExt
);

Параметры

[in, out] pszPath

Тип: LPTSTR

Указатель на строку, завершающуюся значением NULL, MAX_PATH, в которой необходимо заменить расширение.

[in] pszExt

Тип: LPCTSTR

Указатель на буфер символов, содержащий символ ".", за которым следует новое расширение.

Возвращаемое значение

Тип: BOOL

Возвращает ненулевое значение в случае успешного выполнения или ноль, если новый путь и расширение будут превышать MAX_PATH символов.

Замечания

Заметка

Заголовок shlwapi.h определяет PathRenameExtension как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный, Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
библиотеки	Shlwapi.lib
DLL	Shlwapi.dll (версия 4.71 или более поздняя)

Поделиться через