ProcessFile: Difference between revisions
Jump to navigation
Jump to search
m (typo) |
No edit summary |
||
| Line 5: | Line 5: | ||
== Description == | == Description == | ||
ProcessFile should return zero on success, or one of the [[Packer plugins | ProcessFile should return zero on success, or one of the [[Packer plugins developper errors|error values]] otherwise. | ||
* ''hArcData'' contains the handle previously returned by you in [[OpenArchive]]. Using this, you should be able to find out information (such as the archive filename) that you need for extracting files from the archive. | * ''hArcData'' contains the handle previously returned by you in [[OpenArchive]]. Using this, you should be able to find out information (such as the archive filename) that you need for extracting files from the archive. | ||
| Line 24: | Line 24: | ||
| PK_EXTRACT || 2 || Extract to disk | | PK_EXTRACT || 2 || Extract to disk | ||
|} | |} | ||
{{backlink|Packer plugins developer guide|Packer plugins developer guide}} | |||
{{back|Packer plugins developer guide overview|Packer plugins developer guide overview}} | |||
{{back|ReadHeader|ReadHeader}} | |||
Latest revision as of 20:38, 18 April 2006
ProcessFile should unpack the specified file or test the integrity of the archive.
int __stdcall ProcessFile (HANDLE hArcData, int Operation, char *DestPath, char *DestName);
Description
ProcessFile should return zero on success, or one of the error values otherwise.
- hArcData contains the handle previously returned by you in OpenArchive. Using this, you should be able to find out information (such as the archive filename) that you need for extracting files from the archive.
- Unlike PackFiles, ProcessFile is passed only one filename. Either DestName contains the full path and file name and DestPath is NULL, or DestName contains only the file name and DestPath the file path. This is done for compatibility with unrar.dll.
- When Total Commander first opens an archive, it scans all file names with OpenMode==PK_OM_LIST, so ReadHeader() is called in a loop with calling ProcessFile(...,PK_SKIP,...). When the user has selected some files and started to decompress them, Total Commander again calls ReadHeader() in a loop. For each file which is to be extracted, Total Commander calls ProcessFile() with Operation==PK_EXTRACT immediately after the ReadHeader() call for this file. If the file needs to be skipped, it calls it with Operation==PK_SKIP.
- Each time DestName is set to contain the filename to be extracted, tested, or skipped. To find out what operation out of these last three you should apply to the current file within the archive, Operation is set to one of the following:
| Constant | Value | Description |
|---|---|---|
| PK_SKIP | 0 | Skip this file |
| PK_TEST | 1 | Test file integrity |
| PK_EXTRACT | 2 | Extract to disk |
Back to Packer plugins developer guide
Back to Packer plugins developer guide overview Back to ReadHeader