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

Статья
11/20/2024

Извлекает имя подключенной папки на указанном томе. FindFirstVolumeMountPoint используется для начала сканирования подключенных папок на томе.

Синтаксис

HANDLE FindFirstVolumeMountPointW(
  [in]  LPCWSTR lpszRootPathName,
  [out] LPWSTR  lpszVolumeMountPoint,
  [in]  DWORD   cchBufferLength
);

Параметры

[in] lpszRootPathName

Путь GUID тома для тома для проверки подключенных папок. Требуется обратная косая черта.

[out] lpszVolumeMountPoint

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

[in] cchBufferLength

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

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

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

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

Замечания

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

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 определяет FindFirstVolumeMountPoint в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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

См. также

FindNextVolumeMountPoint

FindVolumeMountPointClose

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

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

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