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

Статья
11/20/2024

Удаляет все элементы файла и каталога в пути, кроме корневой информации.

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

Синтаксис

BOOL PathStripToRootA(
  [in, out] LPSTR pszPath
);

Параметры

[in, out] pszPath

Тип: LPTSTR

Указатель на строку длины, завершаемой значением NULL, MAX_PATH, которая содержит путь для преобразования. При успешном возвращении этой функции эта строка содержит только корневую информацию, полученную из этого пути.

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

Тип: BOOL

Возвращает TRUE, если в пути найдена допустимая буква диска или FALSE в противном случае.

Замечания

Заметка

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

Требования

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

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