Click here to Skip to main content
Click here to Skip to main content

CUnrarDLL 1.0 - An MFC UnRAR class

By , 9 Aug 2005
Rate this:
Please Sign up or sign in to vote.

Sample Image - unrar.png

Introduction

In one of my latest projects, I was fiddling around with existing decompression classes, for Zip. I noticed though, that RAR had a far better compression ratio for certain files, and that the existing DLL handled everything itself, including the latest version of the RAR format.

How does the class use 'unrar.dll'?

Unrar.dll is freely distributable, and officially released by RarLabs. It is the interface which existing applications use to manipulate RAR archives. In the class, five functions are exported from the DLL and used.

HANDLE (WINAPI *OpenArchiveEx)(RAROpenArchiveDataEx *pArchiveData);
int    (WINAPI *CloseArchive)(HANDLE hArcData);
int    (WINAPI *ReadRARHeader)(HANDLE hArcData, 
               RARHeaderData *pHeaderData);
int    (WINAPI *ProcessRARFile)(HANDLE hArcData, 
               int iOperation, char* strDestFolder, char* strDestName);
int    (WINAPI *ReadRARHeaderEx)(HANDLE hArcData, 
               struct RARHeaderDataEx *HeaderData);

OpenArchiveEx is used in conjunction with the 'RAROpenArchiveDataEx' structure, to gain a handle to the open archive, if it succeeds. This can then be used in subsequent calls to the DLL. ReadRARHeader is what I use in the core UnRAR function. It is used to process the header of the RAR, to gain information about files contained in the RAR. It fills the RARHeaderData structure with information, including file name, packed size, unpacked etc. ProcessRARFile is used to perform an action on the current file inside the RAR archive. This can be to test, extract, or to skip the file altogether. After being called, it moves to the next file in the archive. CloseArchive is used to close the HANDLE gained from OpenArchiveEx. ReadRARHeaderEx is the same as ReadRARHeader, but contains extra information, such as a Unicode filename.

How it works

CUnrarDLL wraps the 'unrar.dll', freely available from the WinRAR website, and its interface, into a nice, easy-to-use MFC class. UnRARring archives couldn't be simpler.

Here's an example:

// Define an UnRAR object
CUnrarDLL unrarObj;
// Load the RAR file
unrarObj.OpenRARFile("MyContent.rar");
// Set the output directory
unrarObj.SetOutputDirectory("C:\\Output");
// UnRAR the archive
unrarObj.UnRARArchive();

This is all well and good, but what if you wanted to learn more about what's inside an archive, before you extract it? No problem. There are two ways to gain information. The first is done automatically when you call 'OpenRARFile'. Upon opening, CUnrarDLL loads all the files, their packed and unpacked sizes into a vector, which can be examined as below:

// Open the RAR file unrarObj.OpenRARFile("MyContent.rar");
// String to show
CString fileInfo;
// File
CUnrarFile curFile;
// Loop through the files and show them
for (int i = 0; i < unrarObj.GetNumberOfFiles(); i++) {
    curFile = unrarObj.GetFileAt(i);
    fileInfo.Format("File name: %s\nPacked size:" 
           " %I64d\nUnpacked size: %I64d",
           curFile.fileName, curFile.packSize, curFile.unpackSize);
    MessageBox(fileInfo);
}

Another method that has been implemented is 'ListFileNames', which will list only filenames into a CStringArray.

Updates

  • August 4th, 2005: Updated the article.
  • August 3rd, 2005: Initial release.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

About the Author

.rich.w
CEO
United States United States
No Biography provided

Comments and Discussions

 
Questionhow can get the correct filename when it's pathname more than 260characters? Pinmemberbobcow30-Jul-10 15:41 
QuestionHelp me Pinmemberhoogenband16-Jul-08 4:55 
AnswerRe: Help me Pinmemberhoogenband17-Jul-08 21:05 
GeneralRe: Help me Pinmemberhoogenband17-Jul-08 22:33 
Questionprogress Pinmembernonfilter8-Aug-06 20:04 
Generalyour code is old! PinmemberAhfu29-Dec-05 21:39 
GeneralRe: your code is old! Pinmember.rich.w29-Dec-05 23:25 
GeneralRe: your code is old! PinmemberAhfu1-Jan-06 4:10 
GeneralRe: your code is old! Pinmembercareprad4-Jul-07 17:10 
QuestionPasswords? PinsussAnonymous17-Aug-05 10:38 
AnswerRe: Passwords? Pinmember.rich.w19-Aug-05 19:56 
GeneralInteresting article. PinmemberWREY4-Aug-05 6:27 
GeneralRe: Interesting article. Pinmember.rich.w4-Aug-05 6:43 
GeneralRe: Interesting article. Pinmember.rich.w4-Aug-05 6:58 
GeneralRe: Interesting article. [modified] Pinmemberjzcdj29-Apr-08 22:00 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.140415.2 | Last Updated 9 Aug 2005
Article Copyright 2005 by .rich.w
Everything else Copyright © CodeProject, 1999-2014
Terms of Use
Layout: fixed | fluid