[WinAPI] API 13 [遍历指定目录 打印文件和其他属性]

Windows API中，有一组专门的函数和结构，用于遍历目录，它们是FindFirstFile函数、FindNextFile函数和WIN32_FIND_DATA结构。使用FindFirstFile和FindNextFile函数并与do-while循环结合，可以完成遍历目录的任务。
值得一提的是，FindFirstFile输入参数的路径需使用通配符，也就是用户可以根据一些条件来对查找的文件作简单的过滤。下面实例讲解查找特定目录下的所有文件和文件夹。读者可根据自己的需要，指定查找文件的条件。

（1）FindFirstFile。
查找第一个目录或文件，获取查找句柄

◇参数
lpFileName：输入参数，查找的目录，需使用通配符指定查找的文件目标。
lpFindFileData:输出参数，指向WIN32_FIND_DATA结构的指针，为找到的文件及其若干属性信息。
◇返回值
返回HANDLE值，如果执行失败，返回1NVALID HANDLE VALUE，如果成功则返回查找句柄。
◇使用说明
如果查找文件需在循环中与FindNextFile配合使用，FindNextFile需要用到FindFirstFile返回的句柄

（2）FindNextFile
对文件、文件夹进行循环查找，

◇参数
hFindFile:输入参数，查找句柄，由FindFirstFile返回。
lpFindFileData:输出参数，指向WIN32_FIND_DATA结构的指针，为找到的文件及其若干属性信息。
◇返回值
返回BOOL值，表示是否成功。
◇使用说明
需循环查找。

WIN32_FIND_DATA结构用于表示找到的文件，结构中包括文件、目录的名字，创建、最后访问和最后写入时间，文件大小、文件属性等。

>>>本实例实现了对指定目录中文件和子目录的遍历，并将遍历得到的文件和其他属性打印到界面上。

 #include <Windows.h>
 #include <stdio.h>

 DWORD EnumerateFileInDrectory(LPSTR szPath)
 {
     WIN32_FIND_DATA FindFileData;
     HANDLE hListFile;
     CHAR szFilePath[MAX_PATH];

     //构造代表子目录和文件夹路径的字符串，使用通配符“*”
     lstrcpyA(szFilePath,szPath);

     //注释的代码可用于查找所有以".txt"结尾的文件
     //lstrcatA(szFilePath,"\\*.txt");
     lstrcatA(szFilePath,"\\*");
     hListFile=FindFirstFile(szFilePath,&FindFileData);
     //判断句柄
     if(hListFile==INVALID_HANDLE_VALUE)
     {
         printf("错误： %d\n",GetLastError());
         return ;
     }
     else
     {
         do
         {
             /*如果不想显示代表本级目录和上级目录的"."和"..",
             可以使用注释部分的代码过滤
             if(lstrcmp(FindFileData.cFileName,TEXT("."))==0 ||
                 lstrcmp(FindFileData.cFileName,TEXT(".."))==0)
             {
                 continue;
             }
             */
             //打印文件名、目录名
             printf("%s\t\t",FindFileData.cFileName);
             //判断文件属性，是否为加密文件或文件夹
             if(FindFileData.dwFileAttributes && FILE_ATTRIBUTE_ENCRYPTED)
             {
                 printf("<加密> ");
             }
             //判断文件属性，是否为隐藏文件或文件夹
             if(FindFileData.dwFileAttributes && FILE_ATTRIBUTE_HIDDEN)
             {
                 printf("<隐藏> ");
             }
             //判断文件属性，是否为目录
             if(FindFileData.dwFileAttributes && FILE_ATTRIBUTE_DIRECTORY)
             {
                 printf("<DIR> ");
             }
             //根据文件属性表中的内容自行添加、判断文件属性
             printf("\n");
         }while(FindNextFile(hListFile,&FindFileData));
     }
     return ;
 }
 int main(int argc,PCHAR argv[])
 {
     if(argc==)
     {
         EnumerateFileInDrectory(argv[]);
     }
     else
     {
         CHAR szCurrentPath[MAX_PATH];
         GetCurrentDirectoryA(MAX_PATH,szCurrentPath);
         EnumerateFileInDrectory(szCurrentPath);
     }
     return ;
 }

>>>在上个实例的基础上稍加改造，进行循环递归调用，采用树形结构深度遍历的方法。可以遍历指定目录中的所有文件、包括子目录中的文件。

 #include <windows.h>
 #include <stdio.h>

 /* 预处理申明 */
 #pragma comment (lib, "User32.lib")

 /* 全局变量　*/
 //记录所有的文件和目录数
 DWORD dwTotalFileNum = ;

 /* ************************************
 * DWORD ListAllFileInDrectory(LPSTR szPath)
 * 功能    遍历目录及所有子目录，打印路径
 * 参数    LPTSTR szPath，为需遍历的目录
 * 返回值    0代表执行完成，1代码发生错误
 **************************************/
 DWORD ListAllFileInDrectory(LPSTR szPath)
 {
     CHAR szFilePath[MAX_PATH];

     WIN32_FIND_DATA FindFileData;
     HANDLE hListFile;
     CHAR szFullPath[MAX_PATH];

     //构造代表子目录和文件夹路径的字符串，使用通配符“*”
     lstrcpyA(szFilePath, szPath);
     lstrcatA(szFilePath, "\\*");
     //查找第一个文件/目录，获得查找句柄
     hListFile = FindFirstFile(szFilePath,&FindFileData);

     if(hListFile==INVALID_HANDLE_VALUE)
     {
         printf("错误：%d",GetLastError());
         return ;
     }
     else
     {
         do
         {
             //    过滤“.”和“..”，不需要遍历
             if(lstrcmp(FindFileData.cFileName,TEXT("."))==||
                 lstrcmp(FindFileData.cFileName,TEXT(".."))==)
             {
                 continue;
             }
             //构造成全路径
             wsprintfA(szFullPath,"%s\\%s",
                 szPath,FindFileData.cFileName);
             dwTotalFileNum++;
             //打印
             printf("\n%d\t%s\t",dwTotalFileNum,szFullPath);

             //如果是目录，则递归调用，列举下级目录
             if(FindFileData.dwFileAttributes&FILE_ATTRIBUTE_DIRECTORY)
             {
                 printf("<DIR>");
                 ListAllFileInDrectory(szFullPath);
             }
         }
         while(FindNextFile(hListFile, &FindFileData));
     }
     return ;
 }
 int main(int argc, PCHAR argv[])
 {
     if(argc == )//如果有直接调用
     {
         ListAllFileInDrectory(argv[]);
     }
     else//如果没有输入就默认为exe所在处
     {
         CHAR szCurrentPath[MAX_PATH];
         GetCurrentDirectory(MAX_PATH,szCurrentPath);
         ListAllFileInDrectory(szCurrentPath);
     }
     return ;
 }