TElZipReader.OnArchiveError event

TElZipReader.OnArchiveError

This event is fired when an error occurs during archive reading.

Declaration

[C#]
event TSBZipArchiveErrorEvent OnArchiveError;
delegate void TSBZipArchiveErrorEvent(Object Sender, int ErrorCode, string ErrorMessage, ref bool TryContinue);

[VB.NET]
Event OnArchiveError As TSBZipArchiveErrorEvent
Delegate Sub TSBZipArchiveErrorEvent(ByVal Sender As Object, ByVal ErrorCode As Integer, ByVal ErrorMessage As String, ByRef TryContinue As Boolean)

[Pascal]
property OnArchiveError : TSBZipArchiveErrorEvent;
TSBZipArchiveErrorEvent = procedure(Sender : TObject; ErrorCode : integer; const ErrorMessage : string; var TryContinue : boolean) of object;

[C++]
    void get_OnArchiveError(TSBZipArchiveErrorEvent &pMethodOutResult, void * &pDataOutResult);
    void set_OnArchiveError(TSBZipArchiveErrorEvent pMethodValue, void * pDataValue);
    typedef void (SB_CALLBACK *TSBZipArchiveErrorEvent)(void * _ObjectData, TObjectHandle Sender, int32_t ErrorCode, const char * pcErrorMessage, int32_t szErrorMessage, int8_t &TryContinue);

[PHP]
    TSBZipArchiveErrorEvent|callable|NULL get_OnArchiveError()
    void set_OnArchiveError(TSBZipArchiveErrorEvent|callable|NULL $Value)
    callable TSBZipArchiveErrorEvent(TObject $Sender, integer $ErrorCode, string $ErrorMessage, bool &$TryContinue)

[Java]
    TSBZipArchiveErrorEvent getOnArchiveError();
    void setOnArchiveError(TSBZipArchiveErrorEvent Value);
    TSBZipArchiveErrorEvent.Callback OnArchiveError = new TSBZipArchiveErrorEvent.Callback() {
        public void TSBZipArchiveErrorEventCallback(TObject Sender, int ErrorCode, String ErrorMessage, TSBBoolean TryContinue) {
            //...
        }
    }

Parameters

ErrorCode - specifies the error code.
ErrorMessage - contains textual description of the error.
TryContinue - set this parameter to True if you want TElZipReader to try to overcome the error.
pcErrorMessage - contains textual description of the error.
szErrorMessage - the length of pcErrorMessage.

Error codes:

[.NET] [Pascal]	Value	Description
ZIP_ERROR_CDIR_LOCATOR_CORRUPTED	1 (0x0001)	Failed to find end of central directory record. Local file headers may be used to overcome this error.
ZIP_ERROR_ZIP64_LOCATOR_CORRUPTED	2 (0x0002)	Zip64 end of central directory locator record corrupted or not found.
ZIP_ERROR_ZIP64_END_OF_CDIR_CORRUPTED	3 (0x0003)	Zip64 end of central directory record corrupted or not found.
ZIP_ERROR_CENTRAL_HEADER_CORRUPTED	4 (0x0004)	Central file header corrupted.
ZIP_ERROR_CDIR_NOT_FOUND	5 (0x0005)	Central directory not found.

Description

This event is fired when TElZipReader encounters error during archive reading. It is useful when archives are slightly corrupted, and TElZipReader may try to overcome these errors if user sets the TryContinue parameter to True. Instead of creating event handler, IgnoreArchiveErrors property may be used.