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

Статья
11/20/2024

Создает корневой путь из заданного номера диска.

Синтаксис

LPSTR PathBuildRootA(
  [out] LPSTR pszRoot,
  [in]  int   iDrive
);

Параметры

[out] pszRoot

Тип: LPTSTR

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

[in] iDrive

Тип: int

Переменная типа int, указывающая нужный номер диска. Это должно быть от 0 до 25.

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

Тип: LPTSTR

Возвращает адрес созданного корневого пути. Если вызов завершается ошибкой по какой-либо причине (например, недопустимый номер диска), szRoot возвращается без изменений.

Замечания

Заметка

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

Требования

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

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