Параметры

hFindFile

[in] Хендл поиска, полученный при предшествующем вызове функции FindFirstFile.

lpFindFileData

[out] Указатель на структуру WIN32_FIND_DATA, в которую помещается информация о найденном файле или подкаталоге. Структура может быть использована при последующих вызовах FindNextFile для ссылки на найденный файл или каталог.

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

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

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

FindClose

Функция FindClose закрывает заданный хендл поиска. Функции FindFirstFile и FindNextFile используют хендл поиска для выявления файлов с именами, которые соответствуют заданному имени.

BOOL FindClose(

HANDLE hFindFile // хендл поиска файла

);

Параметры

hFindFile

[in/out] Хендл поиска файла. Этот хендл должен быть предварительно открыт функцией FindFirstFile.

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

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

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

Примечания

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

WIN32_FIND_DATA

Структура WIN32_FIND_DATA описывает файл, найденный функцией FindFirstFile, FindFirstFileEx, или FindNextFile.

typedef struct _WIN32_FIND_DATA {

DWORD dwFileAttributes;

FILETIME ftCreationTime;

FILETIME ftLastAccessTime;

FILETIME ftLastWriteTime;

DWORD nFileSizeHigh;

DWORD nFileSizeLow;

DWORD dwReserved0;

DWORD dwReserved1;

TCHAR cFileName[ MAX_PATH ];

TCHAR cAlternateFileName[ 14 ];

} WIN32_FIND_DATA, *PWIN32_FIND_DATA;

Элементы

dwFileAttributes

Задает атрибуты найденного файла. Этот элемент может иметь одно или несколько из нижеперечисленных значений (здесь указаны только основные атрибуты файлов, поддерживаемые большинством файловых систем):

Атрибут	Значение
FILE_ATTRIBUTE_ARCHIVE	Файл или каталог является архивным.
FILE_ATTRIBUTE_DIRECTORY	Каталог.
FILE_ATTRIBUTE_HIDDEN	Файл или каталог скрытый.
FILE_ATTRIBUTE_NORMAL	Файл или каталог не имеет установленных атрибутов. Данный атрибут не может использоваться вместе с другими!
FILE_ATTRIBUTE_READONLY	Файл или каталог только для чтения.
FILE_ATTRIBUTE_SYSTEM	Файл или каталог является частью операционной системы или используется только операционной системой.

ftCreationTime

Задает структуру FILETIME, содержащую время создания файла.

ftLastAccessTime

Задает структуру FILETIME, содержащую время последнего доступа к файлу (структура содержит нули, если файловая система не поддерживает такую информацию).

ftLastWriteTime

Задает структуру FILETIME, содержащую время последней записи в файл (структура содержит нули, если файловая система не поддерживает такую информацию).

nFileSizeHigh

Содержит старшее двойной слово (DWORD) размера файла в байтах.

nFileSizeLow

Содержит младшее двойной слово (DWORD) размера файла в байтах.

dwReserved0

Зарезервировано.

dwReserved1

Зарезервировано.

cFileName

Строка, содержащая имя файла.

cAlternateFileName

Строка, содержащая альтернативное имя файла. Это имя в классическом 8.3 (filename.ext) формате имен файлов.