这里,我们来看1个Unrar官方提供的SDK实现rar文件列举的实例。
以下内容主要运行在Windows环境下,对于Linux需要进行适当的修改。
首先需要使用到RAROpenArchiveEx函数,其原型为:

HANDLE PASCAL RAROpenArchiveEx(struct RAROpenArchiveDataEx *ArchiveData)

其参数为1个结构体RAROpenArchiveDataEx,其结构如下:

struct RAROpenArchiveDataEx
{char         *ArcName;wchar_t      *ArcNameW;unsigned int  OpenMode;unsigned int  OpenResult;char         *CmtBuf;unsigned int  CmtBufSize;unsigned int  CmtSize;unsigned int  CmtState;unsigned int  Flags;UNRARCALLBACK Callback;LPARAM        UserData;unsigned int  OpFlags;wchar_t      *CmtBufW;unsigned int  Reserved[25];
};

在这里主要设置ArcName和OpenMode,其中前者表示压缩包的文件路径,而后者可选值主要有:

• RAR_OM_LIST,只读取文件头
• RAR_OM_EXTRACT,用于测试和解压文件

接着使用RARReadHeaderEx函数读取压缩包文件头:

int PASCAL RARReadHeaderEx(HANDLE hArcData,struct RARHeaderDataEx *HeaderData)

其中RARHeaderDataEx结构体如下:

struct RARHeaderDataEx
{char         ArcName[1024];wchar_t      ArcNameW[1024];char         FileName[1024];wchar_t      FileNameW[1024];unsigned int Flags;unsigned int PackSize;unsigned int PackSizeHigh;unsigned int UnpSize;unsigned int UnpSizeHigh;unsigned int HostOS;unsigned int FileCRC;unsigned int FileTime;unsigned int UnpVer;unsigned int Method;unsigned int FileAttr;char         *CmtBuf;unsigned int CmtBufSize;unsigned int CmtSize;unsigned int CmtState;unsigned int DictSize;unsigned int HashType;char         Hash[32];unsigned int RedirType;wchar_t      *RedirName;unsigned int RedirNameSize;unsigned int DirTarget;unsigned int MtimeLow;unsigned int MtimeHigh;unsigned int CtimeLow;unsigned int CtimeHigh;unsigned int AtimeLow;unsigned int AtimeHigh;unsigned int Reserved[988];
};

最后是RARProcessFileW,用于文件的处理,这里是让其转向下1个头部,其原型为:

int PASCAL RARProcessFileW(HANDLE hArcData,int Operation,wchar_t *DestPath,wchar_t *DestName)

下面是对应实现的代码:

#include <windows.h>
#include <stdlib.h>
#include <stdio.h>
#include <unrar.h>enum ERR_TYPE {ERR_OPEN, ERR_READ, ERR_PROCESS
};typedef struct RARHeaderDataEx RARHeaderDataEx;
typedef struct RAROpenArchiveDataEx RAROpenArchiveDataEx;void OutError(int Error, char *ArcName, int ErrType) {switch (Error) {case ERAR_NO_MEMORY:printf("\nNot enough memory");break;case ERAR_BAD_DATA:printf("\n%s: archive header or data are damaged", ArcName);break;case ERAR_BAD_ARCHIVE:printf("\n%s is not RAR archive", ArcName);break;case ERAR_UNKNOWN_FORMAT:printf("Unknown archive format");break;case ERAR_EOPEN:if (ErrType == ERR_PROCESS) // Returned by RARProcessFile.printf("Volume open error");elseprintf("\nCannot open %s", ArcName);break;case ERAR_ECREATE:printf("File create error");break;case ERAR_ECLOSE:printf("File close error");break;case ERAR_EREAD:printf("Read error");break;case ERAR_EWRITE:printf("Write error");break;case ERAR_SMALL_BUF:printf("Buffer for archive comment is too small, comment truncated");break;case ERAR_UNKNOWN:printf("Unknown error");break;case ERAR_MISSING_PASSWORD:printf("Password for encrypted file or header is not specified");break;case ERAR_EREFERENCE:printf("Cannot open file source for reference record");break;case ERAR_BAD_PASSWORD:printf("Wrong password is specified");break;}
}void PrintHeaderInfo(RARHeaderDataEx header) {// 打印头信息printf("OS=");switch (header.HostOS) {case 0:printf("%s\n", "MS DOS");break;case 1:printf("%s\n", "OS/2");break;case 2:printf("%s\n", "Windows");break;case 3:printf("%s\n", "Unix");break;}// 压缩方法printf("Method=");switch (header.Method) {case 0x30:printf("%s\n", "Storing");break;case 0x31:printf("%s\n", "Fastest compression");break;case 0x32:printf("%s\n", "Fast compression");break;case 0x33:printf("%s\n", "Normal compression");break;case 0x34:printf("%s\n", "Good compression");break;case 0x35:printf("%s\n", "Best compression");break;}printf("File Attribute=%d\n", header.FileAttr);
}int main(int argc, char *argv[]) {if (argc < 2) {printf("%s\n", "Need Filename");return 1;}RAROpenArchiveDataEx data;RARHeaderDataEx header;memset(&header, 0, sizeof(header));memset(&data, 0, sizeof(data));char *ArcName = argv[1];data.ArcName = ArcName;// 只列举文件内容data.OpenMode = RAR_OM_LIST;HANDLE handle = RAROpenArchiveEx(&data);if (data.OpenResult != 0) {printf("%s\n", "Failed!");OutError(data.OpenResult, ArcName, ERR_OPEN);return 1;}int success;int code;//循环读取文件头信息while ((success = RARReadHeaderEx(handle, &header)) == 0) {//指向下1个文件头if ((code = RARProcessFile(handle, RAR_SKIP, NULL, NULL)) == 0) {if (header.Flags == RHDF_DIRECTORY) {//输出目录名称printf("Directory=%ws\n", header.FileNameW);} else {//输出文件名称printf("Filename=%ws\n", header.FileNameW);}}}printf("\n");PrintHeaderInfo(header);if (success != 0) {switch (success) {case ERAR_END_ARCHIVE:printf("%s\n", "End of archive");break;case ERAR_BAD_DATA:printf("%s\n", "File header broken");break;case ERAR_MISSING_PASSWORD:printf("%s\n", "Password was not provided for encrypted file header");break;}return 1;}RARCloseArchive(handle);return 0;
}

其结果类似如下:

                                    
Filename=Microsoft Visual C++ 2015-2019 Redistributable\Filename=Microsoft Visual C++ 2015-2019 Redistributabl
e\Filename=Microsoft Visual C++ 2015-2019 Redistributable\Filename=Microsoft Visual C++ 2015-2019 Redistributa
ble\Microsoft_Visual_CPP_2019_14.22.27821_Redistributable_x64.rar                                             
Filename=Microsoft Visual C++ 2015-2019 Redistributable\Microsoft_Visual_CPP_2019_14.22.27821_Redistributable_
x86.rar                                                                                                       
Filename=Microsoft Visual C++ 2015-2019 Redistributable                                                       OS=Windows                                                                                                    
Method=Storing                                                                                                
File Attribute=16                                                                                             
End of archive