Events > DownloaderSessionFailed event

Remarks

Occurs in case of failure of a downloading session generated by a previous call to one between the Downloader.SessionStartToFile and the Downloader.SessionStartToMemory methods.

For details about management of download sessions from HTTP and FTP servers, refer to the How to manage download sessions tutorial.

For further details about synchronization through Events see the How to synchronize the container application through events tutorial.

Syntax

[Visual Basic]

Public Event DownloaderSessionFailed As DownloaderSessionFailedEventHandler

[C#]

public event DownloaderSessionFailedEventHandler DownloaderSessionFailed;

[C++]

public: __event DownloaderSessionFailedEventHandler DownloaderSessionFailed;

Event Data

The event handler receives an argument of type DownloaderSessionFailedEventArgs having the following parameters:

Parameter

Description

nDllSessionUniqueId

Unique identifier of the downloading session generated by a previous call to one between the Downloader.SessionStartToFile and the Downloader.SessionStartToMemory methods.

nDjErrorCode

Error code generated by the component: see the LastError property for supported values

nWinSdkErrorCode

Eventual error code defined inside the Windows SDK.

nExceptionCause

In case the nDjErrorCode parameter should report an error of type ERR_DOWNLOADER_REMOTE_FILE_FAILURE or ERR_DOWNLOADER_LOCAL_FILE_FAILURE, this parameter reports the eventual file exception raised when accessing the remote or the local file.

Possible exception values can be seen on the table below:

Value	Meaning
1	An unspecified error occurred.
2	The file could not be located.
3	All or part of the path is invalid.
4	The permitted number of open files was exceeded.
5	The file could not be accessed.
6	There was an attempt to use an invalid file handle.
7	The current working directory cannot be removed.
8	There are no more directory entries.
9	There was an error trying to set the file pointer.
10	There was a hardware error.
11	SHARE.EXE was not loaded, or a shared region was locked.
12	There was an attempt to lock a region that was already locked.
13	The disk is full.
14	The end of file was reached.