Функция GetDriveTypeA (fileapi.h)

  • Статья

Определяет, является ли диск съемным, фиксированным, компакт-диском, диском ОЗУ или сетевым диском.

Чтобы определить, является ли диск usb-накопителем, вызовите SetupDiGetDeviceRegistryProperty и укажите свойство SPDRP_REMOVAL_POLICY .

Синтаксис

UINT GetDriveTypeA(
  [in, optional] LPCSTR lpRootPathName
);

Параметры

[in, optional] lpRootPathName

Корневой каталог для диска.

Требуется обратная косая черта в конце. Если этот параметр имеет значение NULL, функция использует корень текущего каталога.

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

Возвращаемое значение указывает тип диска, который может быть одним из следующих значений.

Возвращаемый код/значение Описание
DRIVE_UNKNOWN
0
 Не удается определить тип диска.
DRIVE_NO_ROOT_DIR
1
 Недопустимый корневой путь; Например, по указанному пути нет подключенного тома.
DRIVE_REMOVABLE
2
 Диск имеет съемный носитель; Например, гибкий диск, большой палец или устройство чтения флэш-памяти карта.
DRIVE_FIXED
3
 Диск имеет фиксированный носитель; например, жесткий диск или устройство флэш-памяти.
DRIVE_REMOTE
4
 Диск является удаленным (сетевым) диском.
DRIVE_CDROM
5
 Диск является дисководом компакт-дисков.
DRIVE_RAMDISK
6
 Диск является диском ОЗУ.

Комментарии

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология Поддерживается
Протокол SMB 3.0 Нет
SMB 3.0 Transparent Failover (TFO) Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Да
Восстанавливаемая файловая система (ReFS) Да
 

SMB не поддерживает функции управления томами.

Примечание

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

Требования

   
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header fileapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

GetDiskFreeSpace

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