Функция GetVolumesFromDriveA (ntmsapi.h)
[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]
Функция GetVolumesFromDrive извлекает том и букву диска для данного съемного носителя.
Синтаксис
DWORD GetVolumesFromDriveA(
[in] LPSTR pszDriveName,
[out] LPSTR *VolumeNameBufferPtr,
[out] LPSTR *DriveLetterBufferPtr
);
Параметры
[in] pszDriveName
Имя съемного носителя.
[out] VolumeNameBufferPtr
Том, представляющий съемный носитель.
[out] DriveLetterBufferPtr
Буква диска, представляющая съемный носитель.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается сбоем, возвращаемое значение является одним из кодов системных ошибок.
Комментарии
Эта функция предполагает, что на съемном диске будет только ноль или один раздел, поэтому имеется не более одной буквы диска и одного имени тома.
Примечание
Заголовок ntmsapi.h определяет GetVolumesFromDrive в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | ntmsapi.h |
| Библиотека | Ntmsapi.lib |
| DLL | Ntmsapi.dll |