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

Статья
08/23/2023

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

Синтаксис

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 .

Эта функция возвращает объединение дисков в глобальном и локальном пространствах имен устройств 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

См. также

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

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