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

Статья
08/27/2023

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

Синтаксис

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  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 тома.

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

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

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

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

Примечание

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

Требования


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

См. также

FindNextVolumeMountPoint

FindVolumeMountPointClose

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

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