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

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

Синтаксис

DWORD GetLogicalDriveStringsW(
  [in]  DWORD  nBufferLength,
  [out] LPWSTR lpBuffer
);

Параметры

[in] nBufferLength

Максимальный размер буфера, на который указывает lpBuffer, в TCHARs. Это значение включает пробел для завершающего символа 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 не поддерживает функции управления томами.

Примеры

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

Требования

См. также

GetDiskFreeSpace

GetDriveType

GetLogicalDrives

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