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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hFindVolumeMountPoint

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

[out] lpszVolumeMountPoint

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

[in] cchBufferLength

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

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

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

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

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

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

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

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

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

Примечание

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

Требования

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

См. также

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Подключенные папки

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