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

Статья
11/20/2024

Продолжает поиск подключенной папки, запущенный вызовом функции FindFirstVolumeMountPoint. FindNextVolumeMountPoint находит одну подключенную папку для каждого вызова.

Синтаксис

BOOL FindNextVolumeMountPointA(
  [in]  HANDLE hFindVolumeMountPoint,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

Параметры

[in] hFindVolumeMountPoint

Подключенный дескриптор поиска папок, возвращенный предыдущим вызовом функции FindFirstVolumeMountPoint.

[out] lpszVolumeMountPoint

Указатель на буфер, который получает имя найденной подключенной папки.

[in] cchBufferLength

Длина буфера, получающего имя подключенной папки, в TCHARs.

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

Если функция выполнена успешно, возвращаемое значение ненулевое.

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

Замечания

После установки дескриптора поиска вызовом FindFirstVolumeMountPointможно использовать функцию FindNextVolumeMountPoint для поиска других подключенных папок.

FindFirstVolumeMountPoint, FindNextVolumeMountPointи Функции FindVolumeMountPointClose возвращают пути к подключенным папкам для указанного тома. Они не возвращают буквы диска или пути GUID тома. Сведения о перечислении путей guid guid тома см. в перечислении путей GUID тома.

Не следует предполагать, что какая-либо корреляция между порядком подключенных папок, возвращаемых этими функциями, и порядком подключенных папок, возвращаемых другими функциями или инструментами.

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

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

SMB не поддерживает функции управления томами. CsvFS не поддерживает добавление точки подключения на том CSV. ReFS не индексирует точки подключения.

Заметка

Заголовок winbase.h определяет FindNextVolumeMountPoint в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

FindFirstVolumeMountPoint

FindVolumeMountPointClose

подключенных папок

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

Поделиться через