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

  • Статья

Создает перечисление всех жестких ссылок на указанный файл. Функция FindFirstFileNameW возвращает дескриптор перечисления, который можно использовать при последующих вызовах функции FindNextFileNameW .

Чтобы выполнить эту операцию как транзакцию, используйте функцию FindFirstFileNameTransactedW .

Синтаксис

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Параметры

[in] lpFileName

Имя файла.

Совет Начиная с Windows 10 версии 1607, вы можете согласиться на удаление ограничения MAX_PATH без добавления в начало "\\?\". Дополнительные сведения см. в разделе "Ограничение максимальной длины пути" статьи Именование файлов, путей и пространств имен .
 

[in] dwFlags

Защищены; укажите ноль (0).

[in, out] StringLength

Размер буфера, на который указывает параметр LinkName , в символах. Если этот вызов завершается ошибкой и функция GetLastError возвращает ошибку ERROR_MORE_DATA (234), значение, возвращаемое этим параметром, — это размер буфера, на который указывает LinkName , чтобы содержать все данные.

[in, out] LinkName

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

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

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

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

Комментарии

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

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

Требования

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

См. также

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

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW