Функция 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 |