Classes > ZipMan class > Methods > ZIP.EntryExtractToFile method

Remarks

Extracts into a file on disk a specific entry available inside a ZIP file session previously opened through the ZIP.Open method or created through the ZIP.Create method.

A successful call to this method will fire the ZipOperationStart event followed by a number of ZipOperationPerc events and finally by the ZipOperationDone event.

For further details about methods for ZIP management refer to the ZipMan class.

For details about using ZIP management refer to the How to manage ZIP files tutorial.

Syntax

[Visual Basic]

Public Function EntryExtractToFile (

strEntryName as String,

strPassword as String,

strDestPath as String,

bAddRelativePathToDest as Boolean

) as enumErrorCodes

[C#]

public enumErrorCodes EntryExtractToFile (

string strEntryName,

string strPassword,

string strDestPath,

bool bAddRelativePathToDest

);

[C++]

public: enumErrorCodes EntryExtractToFile (

string strEntryName,

string strPassword,

string strDestPath,

bool bAddRelativePathToDest

);

Parameter

Description

strEntryName

String representing the name of the entry to extract.

strPassword

String containing the optional password for accessing the requested entry; leave it empty if not needed.

strDestPath

String representing the destination path on disk for the given entry

bAddRelativePathToDest

Boolean flag determining if the relative path of the given entry should be added to the destination path.

Supported values are the following:

Value

Meaning

false

The relative path of the entry is not added.

If for example the strEntryName parameter should be "first_dir/second_dir/myFile.mp3" and the strDestPath parameter should be "c:\myfolder", the final pathname of the extracted file would be "c:\myfolder\myFile.mp3"

true

The relative path of the entry is added.

Return value

Value	Meaning

Negative value	An error occurred. Check the LastError property value in order to see the last error.
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.