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

Статья
11/20/2024

Удаляет украшение из строки пути.

Синтаксис

void PathUndecorateW(
  [in, out] LPWSTR pszPath
);

Параметры

[in, out] pszPath

Тип: LPTSTR

Строка длины, завершаемая значением NULL, MAX_PATH, содержащая путь. Когда функция возвращается, pszPath указывает на несоотвержденную строку.

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

Никакой

Замечания

Украшение состоит из пары квадратных скобок с одной или несколькими цифрами между, вставленной сразу после базового имени и до расширения имени файла.

Примеры

В следующей таблице показано, как строки изменяются PathUndecorate.

Начальная строка	Несоотвержденная строка
C:\Path\File[5].txt	C:\Path\File.txt
C:\Path\File[12]	C:\Path\File
C:\Path\File.txt	C:\Path\File.txt
C:\Path\[3].txt	C:\Path\[3].txt

Заметка

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

Требования

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

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