使用微软的FCI/FDI库进行文件压缩

使用微软的FCI/FDI库进行文件压缩
作者：

现在所做的项目由于log内容太多，甚至到几个G。所以，用户要求程序能自动把产生的log压缩，以利于保存和发送。本文简单介绍一下微软的FCI/FDI库，希望对大家有所帮助。

简介：
FCI（File Compression Interface）和FDI（File Decompression Interface）是由微软提供的用于压缩和解压缩的开发包。最大的好处是在WinNT、Win2000、WinXP下系统都提供了相应的API接口。所以，我们的程序不需要额外的压缩库。
本文附带例程只是给大家展示了一些比较简单的用法，大家可以根据微软提供的文档，自己挖掘其他的更强大功能。

API介绍：
FCI/FDI API 用到大量的回调函数，具体函数的原型定义大家可以参考头文件。

一、 FCI

FCI包括5个API。
FCICreate 创建 FCI context
FCIAddFile 向 cabinet 中添加文件
FCIFlushCabinet 结束当前的 cabinet
FCIFlushFolder 结束当前的folder 并建立新的 folder
FCIDestroy 销毁 FCI context

HFCI DIAMONDAPI FCICreate(
	PERF              perf,       	//用于返回错误类型
	PFNFCIFILEPLACED  pfnfiledest,	//用在一个文件跨越多个cabinet时
      	PFNFCIALLOC       pfnalloc,   	//用来分配和释放内存。
      	PFNFCIFREE        pfnfree,
      	PFNFCIOPEN        pfnopen,	//一下6个分别处理文件的创建、读写、
      	PFNFCIREAD        pfnread,	//关闭、定位以及删除等。
      	PFNFCIWRITE       pfnwrite,
      	PFNFCICLOSE       pfnclose,
      	PFNFCISEEK        pfnseek,
	PFNFCIDELETE      pfndelete,
     	PFNFCIGETTEMPFILE pfnfcigtf,	//用于产生临时文件名
      	PCCAB             pccab,	//是一个CCAB结构的指针对压缩文件的详细描述
					//比如：大小、名称、路径等。
	void FAR *        pv            //返回一些context 参数。
);

BOOL DIAMONDAPI FCIAddFile(
	HFCI                 hfci,	//由FCICreate创建的context
     	char                 *pszSourceFile,//被压缩的文件
     	char                 *pszFileName,//此文件在压缩包中的名称
     	BOOL                  fExecute,    //解压时文件是否执行
     	PFNFCIGETNEXTCABINET  GetNextCab,//创建下一个cabinet时调用，这里忽略
     	PFNFCISTATUS          pfnProgress,//周期性的回调函数，可以显示压缩的进度。
     	PFNFCIGETOPENINFO     pfnOpenInfo,//打开文件返回文件句柄及属性
    	TCOMP                 typeCompress   //压缩的类型
)

BOOL DIAMONDAPI FCIFlushCabinet(
	HFCI                  hfci,          //由FCICreate创建的context
      	BOOL                  fGetNextCab, //决定GetNextCab是否被调用
      	PFNFCIGETNEXTCABINET  GetNextCab,//当cabinet满的时候调用
      	PFNFCISTATUS          pfnProgress //同FCIAddFile
)

BOOL DIAMONDAPI FCIFlushFolder(
	HFCI                  hfci,           //参数同上
	PFNFCIGETNEXTCABINET  GetNextCab,
	PFNFCISTATUS          pfnProgress
)
		
BOOL DIAMONDAPI FCIDestroy(
	HFCI	hfci
)

二、 FDI

FDI包括4个API。
FDICreate 创建 FDI context
FDIIsCabinet 判断是否为CAB压缩文件，是则返回其属性
FDICopy 解压
FDIDestroy 销毁 FDI context

HFCI DIAMONDAPI FDICreate(//参数与FCI相应参数差不多
	PFNALLOC 		pfnalloc,
	PFNFREE 		pfnfree,
	PFNOPEN 		pfnopen,
	PFNREAD 		pfnread,
	PFNWRITE 		pfnwrite,
	PFNCLOSE		pfnclose,
	pfnseek,
	int			cpuType,// CPU类型，32位FDI忽略此参数
	PERF			perf
)

BOOL DIAMONDAPI FDIIsCabinet(
	HFDI 			hfdi,        //FDI context
	int 			hf,              //打开的文件句柄
	PFDICABINETINFO 	pfdici   //返回压缩文件的一些属性
)

BOOL FAR DIAMONDAPI FDICopy(
	HFDI          hfdi,
	char FAR     *pszCabinet, //待解压文件名
	char FAR     *pszCabPath, //待解压文件的路径
	int           flags,      //保留，现在必须为0
	PFNFDINOTIFY  pfnfdin,    //回调函数，用来处理FDI的通知
	PFNFDIDECRYPT pfnfdid,    //保留，现在必须为NULL
	void FAR     *pvUser      //作为参数传给回调函数pfnfdin，这里设为NULL
)

注意事项：
1、 用到的库CABINET.DLL，在安装操作系统时已经有了。我们可以用它生成lib库，具体方法可以参照。
2、 一个context只能在创建他的线程使用，如果要使用多线程必须创建多个context。
3、 水平有限，具体以微软提供的文档为准。

--------------------next---------------------

对于解压路径的处理好象不太好,例子中的decompress函数的第二个参数根本无效啊,有什么用呢? ( sammy621 发表于 2008-1-4 16:39:00)
 
CAB压缩包文件最大可达到多大呢？10G的文件还能压缩吗？我用这个方法写过一个压缩程序，如果文件太大就无法压缩了。 ( chrys 发表于 2007-5-9 21:58:00)
 
they can be found at "MSDN Online->Win32 & COM->Development Guides->Developer Notes->Developer Notes->Cabinet SDK API" which related to CABINET.DLL. ( 飘鸥 发表于 2005-9-3 20:34:00)
 
我想请问那也是解压是什么时候调用解压程序的啊? ( niying 发表于 2004-8-13 17:56:00)
 
请问在什么版本的MSDN中能找到这些函数的说明？
注：FDI还包括FDITruncateCabinet。
Cabinet还包括GetDllVersion和DllGetVersion，在压解文件时需不需要先进行版本确认？ ( 周星星 发表于 2003-6-16 10:56:00)
 
顶一下，能不能再写个性能效率比较文档？比如和Winzip的压缩率、压缩时间的比较。 ( 周星星 发表于 2003-6-16 10:11:00)
 
.......................................................

--------------------next---------------------