Функция GetLogicalDriveStringsA (winbase.h)

  • Статья

Заполняет буфер строками, указывающими допустимые диски в системе.

Синтаксис

DWORD GetLogicalDriveStringsA(
  [in]  DWORD nBufferLength,
  [out] LPSTR lpBuffer
);

Параметры

[in] nBufferLength

Максимальный размер буфера, на который указывает lpBuffer, в TCHAR. Этот размер не включает завершающий символ NULL. Если этот параметр равен нулю, lpBuffer не используется.

[out] lpBuffer

Указатель на буфер, который получает ряд строк, заканчивающихся значением NULL, по одной на каждый допустимый диск в системе, а также с дополнительным символом NULL. Каждая строка — это имя устройства.

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

Если функция выполняется успешно, возвращаемое значение — это длина строк, копируемых в буфер, в символах, не включая завершающий символ NULL. Обратите внимание, что пустой символ ANSI-ASCII использует один байт, а символ NULL в Юникоде (UTF-16) — два байта.

Если буфер недостаточно велик, возвращаемое значение больше nBufferLength. Это размер буфера, необходимый для хранения строк диска.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, используйте функцию GetLastError .

Комментарии

Каждую строку в буфере можно использовать везде, где требуется корневой каталог, например для функций GetDriveType и GetDiskFreeSpace .

Эта функция возвращает объединение дисков в глобальном и локальном пространствах имен устройств MS-DOS. Если диск существует в обоих пространствах имен, эта функция вернет запись в локальном пространстве имен устройства MS-DOS. Дополнительные сведения см. в разделе Определение имени устройства MS DOS.

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

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

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

Примеры

Пример см. в разделе Получение имени файла из дескриптора файла.

Требования

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

См. также

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

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