用于文件压缩的微软FCI/FDI库介绍

发布: 2007-7-01 20:40 | 作者: admin | 来源: | 查看: 18次 | 进入软件测试论坛讨论

本文简单介绍一下微软的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，在安装操作系统时已经有了。
2、一个context只能在创建他的线程使用，如果要使用多线程必须创建多个context。