[WinAPI] API 14 [获取、设置文件属性和时间]

>_< 为了获取文件属性，用户可以使用GetFileAttributes与GetFileAttributesEx函数。

GetFileAttributesEx函数除了返回文件属性外，还返回文件时间信息、文件大小等。
GetFileAttributesEx将返回结果保存在WIN32_FILE_ATTRIBUTE DATA结构中。
>_< 获取的文件时间是以FILETIME格式存在的，如果要正确显示，还需要对其时区进行调整，调整为本地时区，然后转换为系统时间格式，便于显示。
>_< 前面在获取文件大小时已经介绍，NTFS文件系统使用了64位数据来表示文件大小。因为32位的数据最多只能表示4GB的大小。Windows将其分为了高32位和低32位，两个都需要使用到，这一点尤其要在对大于4GB的文件操作时注意。

(1)GetFileAttributeS。
获取文件或目录的属牲

◇参数
lpFileName:输入参数，为需要获取属性的文件或目录。 、
◇返回值
返回DWORD值，表示文件属性。如果返回INVALID_FILE ATTRIBUTES，则表示失败。可使用GetLastError函数获取错误信息。
◇使用说明
要判断文件具体有哪些属性，需要使用“&”与属性常量进行运算，如果运行结果为真，则表示具有这种属性。

（2）GetFileAttributesEx。
获取文件或目录的属性、时间、大小，以WIN32_FILE ATTRIBUTE_DATA结构的形式返回结果

◇参数
lpFileName:输入参数，为需要获取属性的文件或目录。
flnfoLevelId:输入参数，是获取文件属性信息的类别，会影响到lpFileInformation参数具体采用什么形式输出结果。但是本参数一般只能指定为GetFileExInfoStandard。
lpFileInformation：输出参数，用于返回结果。如果flnfoLevelId参数指定为GetFileExInfoStandard，则为LPWIN32_FILE_ATTRIBUTE_ DATA类型。
◇返回值
返回BOOL值，表示是否成功。

(3) SetFileAttributes.
设置文件或目录的属性

◇参数
lpFileName：输入参数，为需要设置属性的文件或目录。
dwFileAttributes:文件属性值。
◇返回值
返回BOOL值，表示是否成功。
◇使用说明
文件系统中对文件属性的表示使用了DWORD类型的数据，多个文件属性使用“【”运算连接在一起

（4）FileTimeToLocalFileTime。
把文件时间转换为本地的文件时间

◇参数
lpFileTime：输入参数，为需要转换的文件时间。
lpLocalFileTime：输出参数，为指向转换后的文件时间。
◇返回值
返回BOOL值，表示是否成功。

（5）FileTimeToSystemTime
将文件时间转换为系统时间（SYSTEMTIME格式），便于显示

◇参数
lpFileTime：输入参数，指向需要转换的文件时间。
lpSystemTime：输出参数，指向转换后的SYSTEMTIME。
◇返回值
返回BOOL值，表示是否成功。

>_< 关键数据结构

(1) FILETIM。
此结构用最小的数据量表示的时间，但是不便于用户查看和显示。通过API获取的系统时间都是这种格式的。如果要使用显示，可以使用FileTimeToSystemTime转换为便于显示的SYSTEMTIME结构

(2) SYSTEMTIME。
此结构使用了较为直观的方式表示时间。

(3) WIN32_FILE ATTRIBUTE_DATA。
GetFileAttributesEx使用这个结构表示返回结果，包括文件属性、文件创建时间、文件最后访问时间、文件最后写入时间和文件大小。

>>>本实例编译完成后是一个可执行文件，运行时需输入两个参数，均是文件路径，程序将第一个参数所指向的文件和目录的属性显示出来，将第二个参数所指向的文件或目录设置为隐藏和只读。

 // 获取、设置文件属性和时间
 #include <windows.h>
 #include <stdio.h>

 /* 函数申明　*/
 DWORD ShowFileTime(PFILETIME lptime);
 DWORD ShowFileSize(DWORD dwFileSizeHigh,DWORD dwFileSizeLow);
 DWORD ShowFileAttrInfo(DWORD dwAttribute);
 DWORD SetFileHiddenAndReadonly(LPSTR szFileName);

 /* ************************************
  * DWORD ShowFileAttributes(LPSTR szPath)
  * 功能    获取并显示文件属性，
  *        调用ShowFileTime、ShowFileSize和
  *        ShowFileAttrInfo函数
  *
  * 参数    LPTSTR szPath，获取并显示此文件的属性
  *
  * 返回值    0代表执行完成，1代码发生错误
  **************************************/
 DWORD ShowFileAttributes(LPSTR szPath)
 {
     //文件属性结构
     WIN32_FILE_ATTRIBUTE_DATA wfad;
     printf("文件：%s\n",szPath);
     //获取文件属性
     if(!GetFileAttributesExA(szPath,
         GetFileExInfoStandard,
         &wfad))
     {
         printf("获取文件属性错误：%d\n",GetLastError());
         return ;
     }
     //显示相关时间
     printf("创建时间：\t");
     ShowFileTime(&(wfad.ftCreationTime));
     printf("最后访问时间：\t");
     ShowFileTime(&(wfad.ftLastAccessTime));
     printf("最后修改时间：\t");
     ShowFileTime(&(wfad.ftLastWriteTime));
     //显示文件大小
     ShowFileSize(wfad.nFileSizeHigh,wfad.nFileSizeLow);
     //显示文件属性
     ShowFileAttrInfo(wfad.dwFileAttributes);

     return ;
 }
 /* ************************************
  * DWORD ShowFileAttrInfo(DWORD dwAttribute)
  * 功能    打印将文件属性
  *
  * 参数    DWORD dwAttribute，文件属性
  *
  * 返回值 0
  **************************************/
 DWORD ShowFileAttrInfo(DWORD dwAttribute)
 {
     //依次判断属性，并显示。
     printf("文件属性：\t");
     if(dwAttribute&FILE_ATTRIBUTE_ARCHIVE)
         printf("<ARCHIVE> ");
     if(dwAttribute&FILE_ATTRIBUTE_COMPRESSED)
         printf("<压缩> ");
     if(dwAttribute&FILE_ATTRIBUTE_DIRECTORY)
         printf("<目录> ");
     if(dwAttribute&FILE_ATTRIBUTE_ENCRYPTED)
         printf("<加密> ");
     if(dwAttribute&FILE_ATTRIBUTE_HIDDEN)
         printf("<隐藏> ");
     if(dwAttribute&FILE_ATTRIBUTE_NORMAL)
         printf("<NORMAL> ");
     if(dwAttribute&FILE_ATTRIBUTE_OFFLINE)
         printf("<OFFLINE> ");
     if(dwAttribute&FILE_ATTRIBUTE_READONLY)
         printf("<只读> ");
     if(dwAttribute&FILE_ATTRIBUTE_SPARSE_FILE)
         printf("<SPARSE> ");
     if(dwAttribute&FILE_ATTRIBUTE_SYSTEM)
         printf("<系统文件> ");
     if(dwAttribute&FILE_ATTRIBUTE_TEMPORARY)
         printf("<临时文件> ");

     printf("\n");

     return ;
 }
 /* ************************************
  * DWORD ShowFileSize(DWORD dwFileSizeHigh, DWORD dwFileSizeLow)
  * 功能    打印文件大小信息
  *
  * 参数    DWORD dwFileSizeHigh，文件大小高32位
  *        DWORD dwFileSizeLow，文件大小低32位
  *
  * 返回值 0
  **************************************/
 DWORD ShowFileSize(DWORD dwFileSizeHigh, DWORD dwFileSizeLow)
 {
     ULONGLONG liFileSize;
     liFileSize = dwFileSizeHigh;

     //高们移动32位
     liFileSize <<= sizeof(DWORD)*;
     liFileSize += dwFileSizeLow;
     printf("文件大小：\t%I64u 字节\n",liFileSize);
     return ;
 }
 /* ************************************
  *DWORD ShowFileTime(PFILETIME lptime)
  * 功能    轮换文件时间，将打印
  *
  * 参数    PFILETIME lptime，指向文件时间的指针
  *
  * 返回值 0
  **************************************/
 DWORD ShowFileTime(PFILETIME lptime)
 {
     //文件时间结构
     FILETIME ftLocal;
     //系统时间结构
     SYSTEMTIME st;
     //调整为系统所在时区的时间
     FileTimeToLocalFileTime(
         lptime,
         &ftLocal
         );
     //将文件时间转换为SYSTEMTIME格式，便于显示。
     FileTimeToSystemTime(
         &ftLocal,
         &st
         );
     //显示时间信息字符串
     printf("%4d年%.2d月%#02d日，%.2d:%.2d:%.2d\n",
         st.wYear,st.wMonth,st.wDay,st.wHour,st.wMinute,st.wSecond);

     return ;
 }
 /* ************************************
  * DWORD SetFileHiddenAndReadonly(LPSTR szFileName)
  * 功能    将指定的文件设置为隐藏和只读
  *
  * 参数    LPSTR szFileName，文件路径
  *
  * 返回值 0
  **************************************/
 DWORD SetFileHiddenAndReadonly(LPSTR szFileName)
 {
     //获取原来的文件属性
     DWORD dwFileAttributes = GetFileAttributesA(szFileName);
     //将只读和隐藏属性附加到原来的文件属性上
     dwFileAttributes |= FILE_ATTRIBUTE_READONLY;
     dwFileAttributes |= FILE_ATTRIBUTE_HIDDEN;
     //设置文件属性，并判断是否成功。
     if(SetFileAttributesA(szFileName, dwFileAttributes))
     {
         printf("文件%s的隐藏和属性设置成功\n",szFileName);
     }
     else
     {
         printf("属性设置; %d\n",GetLastError());
     }
     return ;
 }
 /* ************************************
  * int main(int argc, PCHAR argv[])
  * 功能    设置和获取文件属性等
  *
  * 参数    显示第一个参数指定文件的属性、时间、大小
  *        将第二个参数的属性设置为隐藏、只读。
  *
  * 返回值    0代表执行完成，1代码发生错误
  **************************************/
 int main(int argc, PCHAR argv[])
 {
     char str1[];
     char str2[];
     printf("请输入参数\n");
     scanf("%s",str1);scanf("%s",str2);

     ShowFileAttributes(str1);
     SetFileHiddenAndReadonly(str2);
     return ;
 }