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

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

  • Статья

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

Синтаксис

LPWSTR PathBuildRootW(
  [out] LPWSTR pszRoot,
  [in]  int    iDrive
);

Параметры

[out] pszRoot

Тип: LPTSTR

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

[in] iDrive

Тип: int

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

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

Тип: LPTSTR

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

Комментарии

Примечание

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

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 4.71 или более поздняя)