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

Статья
02/28/2024

Закрывает дескриптор поиска файлов, открытый функциями FindFirstFile,FindFirstFileEx, FindFirstFileNameW, FindFirstFileNameTransactedW, FindFirstFileTransacted, FindFirstStreamTransactedW или FindFirstStreamW .

Синтаксис

BOOL FindClose(
  [in, out] HANDLE hFindFile
);

Параметры

[in, out] hFindFile

Дескриптор поиска файла.

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

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

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

После вызова функции FindClose дескриптор, указанный параметром hFindFile , не может использоваться в последующих вызовах функций FindNextFile, FindNextFileNameW, FindNextStreamW или FindClose .

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

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

Примеры

Пример см. в разделе Перечисление файлов в каталоге.

Требования

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