Функция GetLogicalDriveStringsW (fileapi.h)
Заполняет буфер строками, указывающими допустимые диски в системе.
DWORD GetLogicalDriveStringsW(
[in] DWORD nBufferLength,
[out] LPWSTR lpBuffer
);
[in] nBufferLength
Максимальный размер буфера, на который указывает lpBuffer, в TCHAR. Этот размер не включает завершающий символ NULL. Если этот параметр равен нулю, lpBuffer не используется.
[out] lpBuffer
Указатель на буфер, который получает последовательность строк, заканчивающихся значением NULL, по одной для каждого допустимого диска в системе, а также с дополнительным символом NULL. Каждая строка является именем устройства.
Если функция выполнена успешно, возвращаемое значение представляет собой длину строк, скопированных в буфер, в символах, не включая завершающий символ NULL. Обратите внимание, что символ NULL ANSI-ASCII использует один байт, а символ Юникода (UTF-16) — два байта.
Если буфер недостаточно велик, возвращаемое значение больше nBufferLength. Это размер буфера, необходимый для хранения строк диска.
Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .
Каждая строка в буфере может использоваться везде, где требуется корневой каталог, например для функций GetDriveType и GetDiskFreeSpace .
Эта функция возвращает объединение дисков в глобальном и локальном пространствах имен устройств MS-DOS. Если диск существует в обоих пространствах имен, эта функция возвращает запись в пространстве имен Локальное устройство MS-DOS. Дополнительные сведения см. в разделе Определение имени устройства MS DOS.
В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.
| Технология | Поддерживается |
|---|---|
| Протокол SMB 3.0 | Нет |
| Прозрачная отработка отказа (TFO) SMB 3.0 | Нет |
| SMB 3.0 с масштабируемыми общими папками (SO) | Нет |
| Файловая система общего тома кластера (CSVFS) | Да |
| Восстанавливаемая файловая система (ReFS) | Да |
SMB не поддерживает функции управления томами.
Пример см. в разделе Получение имени файла из дескриптора файла.
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | fileapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |