请输入您要查询的百科知识:

 

词条 FindFirstFile
释义

VB声明

Declare Function FindFirstFile Lib "kernel32" Alias "FindFirstFileA" (ByVal lpFileName As String, lpFindFileData As WIN32_FIND_DATA) As Long

说明

根据文件名查找文件

返回值

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

参数表

参数 类型及说明

lpFileName String,欲搜索的文件名。参数可如下

c:\\Windows\\*.* //在c:\\Windows目录中查找所有文件 c:\\Windows\\System32\\*.dll //在c:\\Windows\\System32目录中查找所有dll文件

c:\\Windows\\System.ini ;在c:\\Windows目录中查找System.ini文件

c:\\Windows\\a???.* // 在c:\\Windows目录中查找所有以a开头的文件名长度.为4个字符的文件

Test.dat //在当前目录查找Test.dat文件

*.* //在当前目录查找所有文件

(注!一定要带文件名。如果参数为“c:\\Windows”,则返回的文件名为“Windows”,并且接下来调用FindNextFile会返回失败)

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

结构说明:

WIN32_FIND_DATA STRUCT

dwFileAttributes DWORD ? ;文件属性

ftCreationTime FILETIME <> ;文件的创建日期

ftLastAccessTime FILETIME <> ;文件的最后存取日期

ftLastWriteTime FILETIME <> ;文件的最后修改日期

nFileSizeHigh DWORD ? ;文件长度的高32位

nFileSizeLow WORD ? ;文件长度的低32位

dwReserved0 DWORD ? ;内部使用

dwReserved1 DWORD ? ;内部使用

cFileName BYTE MAX_PATH dup(?) ;本次找到的文件名

cAlternate BYTE 14 dup(?) ;文件的8.3结构的短文件名

WIN32_FIND_DATA ENDS

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

FILE_ATTRIBUTE_ARCHIVE——文件包含归档属性。

FILE_ATTRIBUTE_COMPRESSED——文件和目录被压缩。

FILE_ATTRIBUTE_DIRECTORY——找到的是一个目录。

FILE_ATTRIBUTE_HIDDEN——文件包含隐含属性。

FILE_ATTRIBUTE_NORMAL——文件没有其他属性。

FILE_ATTRIBUTE_READONLY——文件包含只读属性。

FILE_ATTRIBUTE_SYSTEM——文件包含系统属性。

FILE_ATTRIBUTE_TEMPORARY——文件是一个临时文件。

(返回的文件名中会包含"."和".."。“.'代表本目录,".."代表上一层目录。一般情况下需要把这两个名称过滤掉。比如要进行文件删除操作)

注解

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

VC声明

HANDLE FindFirstFile(

LPCTSTR lpFileName, // file name

LPWIN32_FIND_DATA lpFindFileData // data buffer

);

功能说明

该函数到一个文件夹(包括子文件夹)去搜索指定文件 如果要使用附加属性去搜索文件的话 可以使用FindFirstFileEx函数

参数说明

HANDLE hFindFile搜索的文件句柄 函数执行的时候搜索的是此句柄的下一文件

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

返回值

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

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

随便看

 

百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2025/3/1 14:25:14