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

Статья
11/20/2024

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

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

Синтаксис

UINT GetDriveTypeW(
  [in, optional] LPCWSTR 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	Диск — это диск CD-ROM.
DRIVE_RAMDISK 6	Диск является диском ОЗУ.

Замечания

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2003 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	fileapi.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

GetDiskFreeSpace

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

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