SHFileOperation函数

(3) 2024-04-29 15:23

Hi,大家好,我是编程小6,很荣幸遇见你,我把这些年在开发过程中遇到的问题或想法写出来,今天说一说SHFileOperation函数,希望能够帮助你!!!。

在Windows的shellapi文件中定义了一个名为SHFileOperation()的外壳函数,用它可以实现各种文件操作,如文件的拷贝、删除、移动等,该函数使用起来非常简单,它只有一个指向SHFILEOPSTRUCT结构的参数。使用SHFileOperation()函数时只要填写该专用结构--SHFILEOPSTRUCT,告诉Windows执行什么样的操作,以及其它重要信息就行了。SHFileOperation()的特别之处在于它是一个高级外壳函数,不同于低级文件处理。当调用SHFileOperation操作文件时,相应的外壳拷贝处理器(如果有的话)被调用。如在删除某个文件时,SHFileOperation会将删除的文件放到Recycle Bin中。SHFileOperation()函数的原形为:   

  WINSHELLAPI int WINAPI SHFileOperation (LPSHFILEOPSTRUCT lpFIleOp); 

  函数中参数类型为一个LPSHFILEOPSTRUCT结构,它包含有进行文件操作的各种信息,其具体的结构如下:   

  Typedef struct _ShFILEOPSTRUCT 

  { 

   HWND hWnd; //消息发送的窗口句柄; 

   UINT wFunc; //操作类型 

   LPCSTR pFrom; //源文件及路径 

   LPCSTR pTo; //目标文件及路径 

   FILEOP_FLAGS fFlags; //操作与确认标志 

   BOOL fAnyOperationsAborted; //操作选择位 

   LPVOID hNameMappings; //文件映射 

   LPCSTR lpszProgressTitle; //文件操作进度窗口标题 

  }SHFILEOPSTRUCT, FAR * LPSHFILEOPSTRUCT;    

  在这个结构中,hWnd是指向发送消息的窗口句柄,pFrom与pTo是进行文件操作的源文件名和目标文件名,它包含文件的路径,对应单个文件的路径字符串,或对于多个文件,必须以NULL作为字符串的结尾或文件路径名之间的间隔,否则在程序运行的时候会发生错误。另外,pFrom和pTo都支持通配符*和?,这大大方便了开发人员的使用。例如,源文件或目录有两个,则应是:char pFrom[]="d:/Test1/0d:/Text.txt/0",它表示对要D:盘Test1目录下的所有文件和D:盘上的Text.txt文件进行操作。字符串中的""是C语言中的''的转义符,'/0'则是NULL。wFunc 是结构中的一个非常重要的成员,它代表着函数将要进行的操作类型,它的取值为如下: 

  ·FO_COPY: 拷贝文件pFrom到pTo 的指定位置。 

  ·FO_RENAME: 将pFrom的文件名更名为pTo的文件名。 

  ·FO_MOVE: 将pFrom的文件移动到pTo的地方。 

  ·FO_DELETE: 删除pFrom指定的文件。 

  使用该函数进行文件拷贝、移动或删除时,如果需要的时间很长,则程序会自动在进行的过程中出现一个无模式的对话框(Windows操作系统提供的文件操作对话框),用来显示执行的进度和执行的时间,以及正在拷贝、移动或删除的文件名,此时结构中的成员lpszProgressTitle显示此对话框的标题。fFlags是在进行文件操作时的过程和状态控制标识。它主要有如下一些标识,也可以是其组合: 

  ·FOF_FILESONLY:执行通配符,只执行文件; 

  ·FOF_ALLOWUNDO:保存UNDO信息,以便在回收站中恢复文件; 

  ·FOF_NOCONFIRMATION:在出现目标文件已存在的时候,如果不设置此项,则它会出现确认是否覆盖的对话框,设置此项则自动确认,进行覆盖,不出现对话框。 

  ·FOF_NOERRORUI:设置此项后,当文件处理过程中出现错误时,不出现错误提示,否则会进行错误提示。    

  ·FOF_RENAMEONCOLLISION:当已存在文件名时,对其进行更换文提示。 

  ·FOF_SILENT:不显示进度对话框。 

  ·FOF_WANTMAPPINGHANDLE:要求SHFileOperation()函数返回正处于操作状态的实际文件列表,文件列表名柄保存在hNameMappings成员中。 

  ·SHFILEOPSTRUCT结构还包含一个SHNAMEMAPPING结构的数组,此数组保存由SHELL计算的每个处于操作状态的文件的新旧路径。 
 

 

同时也有一个重要的应用就是:

在进行文件操作时,可以使用CFile类中的Remove()函数来删除一个文件,但是这样的操作将永久性的删除该文件,不能在必要的时候再恢复该文件,解决这个问题的唯一方法就是把文件送到Windows系统中的回收站(Recycle Bin)里面,而不是简单的永久性删除它,这样用户就可以在必要的时候恢复这个文件。用这个函数实现编程来实现Windows回收站的文件存取操作。

在使用该函数删除文件时必须设置SHFILEOPSTRUCT结构中的神秘FOF_ALLOWUNDO标志,这样才能将待删除的文件拷到Recycle Bin,从而使用户可以撤销删除操作。需要注意的是,如果pFrom设置为某个文件名,用FO_DELETE标志删除这个文件并不会将它移到Recycle Bin,甚至设置FOF_ALLOWUNDO标志也不行,在这里你必须使用全路径名,这样SHFileOperation才会将删除的文件移到Recycle Bin。

 

代码如下:

 void CFileOperationView::OnFileDelete() 

  { 

   int nOk; 

   char strSrc[]="d:/Vb/0";//源文件路径; 

   char strDst[]="d:/Vb1/0";//目标文件路径; 

   char strTitle[]="文件拷贝"; //文件删除进度对话框标题 

   SHFILEOPSTRUCT FileOp;//定义SHFILEOPSTRUCT结构对象; 

   FileOp.hwnd=this->m_hWnd; 

   FileOp.wFunc=FO_DELETE; //执行文件删除操作; 

   FileOp.pFrom=strSrc; 

   FileOp.pTo=strDst; 

   FileOp.fFlags=FOF_ALLOWUNDO;//此标志使删除文件备份到Windows回收站 

   FileOp.hNameMappings=NULL; 

   FileOp.lpszProgressTitle=strTitle; 

   //开始删除文件 

   nOk=SHFileOperation(&FileOp); 

   if(nOk) 

    TRACE("There is an error: %d/n",nOk); 

   else 

    TRACE("SHFileOperation finished successfully/n"); 

  } 

今天的分享到此就结束了,感谢您的阅读,如果确实帮到您,您可以动动手指转发给其他人。

上一篇

已是最后文章

下一篇

已是最新文章

发表回复