FindFirstFile_函数 - 威林百科weilinceramic.com

FindFirstFile

函数

FindFirstFile是一个函数。根据文件名查找文件，该函数到一个文件夹(包括子文件夹)去搜索指定文件如果要使用附加属性去搜索文件的话可以使用FindFirstFileEx函数。

参数简介

返回值

Long，如执行成功，返回一个搜索句柄。如果出错，返回一个INVALID_HANDLE_VALUE常数，一旦不再需要，应该用FindClose函数关闭这个句柄

如果调用成功返回一个句柄，可用来做为FindNextFile或 FindClose参数

调用失败返回为INVALID_HANDLE_VALUE(即-1) ,可调用GetLastError来获取错误信息

参数表

参数类型及说明

lpFileNameString，欲搜索的文件名。参数可如下

lpFindFileDataWIN32_FIND_DATA，这个结构用于装载与找到的文件有关的信息。该结构可用于后续的搜索

结构说明

dwFileAttributes字段可以是下面取值的组合，通过这个字段可以检查找到的究竟是一个文件还是一个子目录，以及其他的文件属性：

注解

由这个函数返回的句柄可以作为一个参数用于FindNextFile函数。这样一来，就可以方便的枚举出与lpFileName参数指定的文件名相符的所有文件

VC声明

程序例

参数说明

LPCTSTR lpFileName文件名（包括路径）

LPWIN32_FIND_DATA lpFindFileData 指向一个用于保存文件信息的结构体

参考资料

最新修订时间：2024-12-03 21:26

条目作者

概述

参数简介

返回值

参考资料