16 сент. 2010 г.

GetVolumePathNamesForVolumeName

Поддерживается на Windows Vista / XP / 2000Pro
Функция GetVolumePathNamesForVolumeName получает список имен путей для указанного имени раздела.
BOOL GetVolumePathNamesForVolumeName(
  LPCTSTR lpszVolumeName,
  LPTSTR lpszVolumePathNames,
  DWORD cchBufferLength,
  PDWORD lpcchReturnLength
);
Параметры:

lpszVolumeName Адрес строки, которая определяет имя раздела.
lpszVolumePathNames Адрес буфера, кторый получает список имен путей раздела. Список – это массив из нульзаканчивающихся строк, заканчивающимися дополнительным символом NULL. Если размера буфера не достаточно для сохранения списка, в буфер помещается столько, сколько в него вмещается.
cchBufferLength Размер буфера lpszVolumePathNames в TCHAR.
lpcchReturnLength Если вызов успешен, этот параметр будет количеством символов TCHAR, скопированных в буфер lpszVolumePathNames. Иначе, этот параметр является размером буфера, требуемый для сохранения всего списка.
Возвращаемые значения:
Если вызов функции успешен, возвращается ненулевое значение.
При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызывайте GetLastError. Если буфер мал для сохранения всего списка, кодом ошибки будет ERROR_MORE_DATA и параметр lpcchReturnLength получает размер буфера.
Замечания:
Для компиляции приложения, которое использует эту функцию, объявите макрос _WIN32_WINNT со значением 0x0500 или больше.
Смотрите также:
FindNextVolume, FindVolumeClose