Функция GetVolumesFromDriveW (ntmsapi.h)

  • Статья

[Диспетчер съемных носителей больше недоступен в Windows 7 и Windows Server 2008 R2.]

Функция GetVolumesFromDrive извлекает том и букву диска для данного съемного носителя.

Синтаксис

DWORD GetVolumesFromDriveW(
  [in]  LPWSTR pszDriveName,
  [out] LPWSTR *VolumeNameBufferPtr,
  [out] LPWSTR *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

См. также раздел

GetNtmsObjectInformation

Функции управления библиотекой