Download DLL

About

ISX Download DLL is a "plugin" for ISX that allows you to download files from the Internet during the installation process.

Primarily written to be used from Inno Setup, but can be used by any software that can call DLL's. If you have the declarations needed for VB or other languages, please send them to me to include them on this page.

Definitions for ISX Pascal Scripting

function isxdl_Download(hWnd: Integer; URL, Filename: PChar): Integer;
external 'isxdl_Download@files:isxdl.dll stdcall';

procedure isxdl_AddFile(URL, Filename: PChar);
external 'isxdl_AddFile@files:isxdl.dll stdcall';

procedure isxdl_AddFileSize(URL, Filename: PChar; Size: Cardinal);
external 'isxdl_AddFileSize@files:isxdl.dll stdcall';

function isxdl_DownloadFiles(hWnd: Integer): Integer;
external 'isxdl_DownloadFiles@files:isxdl.dll stdcall';

procedure isxdl_ClearFiles;
external 'isxdl_ClearFiles@files:isxdl.dll stdcall';

function isxdl_IsConnected: Integer;
external 'isxdl_IsConnected@files:isxdl.dll stdcall';

function isxdl_SetOption(Option, Value: PChar): Integer;
external 'isxdl_SetOption@files:isxdl.dll stdcall';

function isxdl_GetFileName(URL: PChar): PChar;
external 'isxdl_GetFileName@files:isxdl.dll stdcall';

Definitions for Visual Basic

Public Declare Function isxdl_Download Lib "isxdl.dll" _
(ByVal ihWnd As Integer, ByVal strURL As String, ByVal strFilename As String) As Integer
 
Public Declare Function isxdl_AddFile Lib "isxdl.dll" _
(ByVal strURL As String, ByVal strFilename As String) As Integer
 
Public Declare Function isxdl_AddFileSize Lib "isxdl.dll" _
(ByVal strURL As String, ByVal strFilename As String, ByVal lngSize As Long) As Integer
 
Public Declare Function isxdl_DownloadFiles Lib "isxdl.dll" _
(ByVal ihWnd As Integer) As Integer
 
Public Declare Sub isxdl_ClearFiles Lib "isxdl.dll" ()
 
Public Declare Function isxdl_IsConnected Lib "isxdl.dll" () As Integer
 
Public Declare Function isxdl_SetOption Lib "isxdl.dll" _
(ByVal strOption As String, ByVal strValue As String) As Integer
 
Public Declare Function isxdl_GetFileName Lib "isxdl.dll" _
(ByVal strRL As String) As String

Definitions for C++

extern "C" {
	int isxdl_Download(HWND hWndParent,LPCTSTR pszURL,LPCTSTR pszFileName);
	void isxdl_AddFile(LPCTSTR pszURL,LPCTSTR pszFileName);
	void isxdl_AddFileSize(LPCTSTR pszURL,LPCTSTR pszFileName,DWORD dwSize);
	int isxdl_DownloadFiles(HWND hWndParent);
	void isxdl_ClearFiles(void);
	int isxdl_IsConnected(void);
	int isxdl_SetOption(LPCTSTR pszOption,LPCTSTR pszValue);
	LPCTSTR isxdl_GetFileName(LPCTSTR pszURL);
};

History

Version 5.1.0

Can use a custom wizard image.
Uses SIZE command to get size of files on ftp servers.
Disabled optimization - is it me or is msvc bugging?
Won't add identical files more than once.
Disabled resume.

Version 4.0.8

Fixed a bug in resume if the server didn't support resume.
A bug caused by aborting a download was fixed.
Numbers are formatted in the default user locale.
Fixed bug that prevented cancelling downloads for illegal addresses.
Asks for user name and password if necessary when download from ftp.
Changed some error messages.
Shows icon for system menu.
Uses MS Shell Dlg font.
If resume is disabled, incomplete files will be deleted.

Version 3.0.4.3

Can use language files.
Doesn't hide parent window in simple mode.
Bug fixes.
Supports resume for http.
Spanish translation by Lobo Lunar.
Norwegian translation.

Version 3.0.4 (11/30/2002)

Doesn't get size of files in simple mode.
Bugfix in isxdl_SetOption and resetting simple mode.
Standard wizard look.
Automatically hides parent window.
Two new options: label and description.

Version 1.3.1 (7/24/2002)

Minor tweaks and modifications.
Added function isxdl_GetFileName to give you the real name of the downloaded file.
Fixed overflow when calculating remaining time.
Added a little about box.
Improved handling of progress bars.
Added new option 'simple' that gives you a simple window with a custom message.

Version 1.3.0 (7/15/2002)

Abort should really abort (possible memory leaks though).
Supports ftp.
Handles HTTP_STATUS_MOVED if not handled by wininet (untested).
Added function IsConnected to tell whether the computer is connected to the Internet or not (experimental?). Requires IE4.
Added function SetOption to set options. Supported options are: 'title', 'noftpsize', 'debug', 'resume', 'language', 'label', 'description'.
Added prefix 'isxdl_' to all functions.
Added function AddFileSize with a parameter for file size. Means the DLL will not need to check the size itself.

Version 1.2.1

Minor tweaks.
Added method ClearFiles to clear the internal file list.

Version 1.2.0

No more divide by zero errors for files less than 1024 bytes.
Supports user name and password in the url.
Demo scripts for both ISX2 and ISX3.

Version 1.0.0

Initial release.

isxdl_Download

Immediately downloads a file from the Internet.

Syntax

int isxdl_Download(
	HWND	hWndParent,
	LPCTSTR	pszURL,
	LPCTSTR	pszFileName
);

Parameters

hWndParent

Handle to parent window.

pszURL

The URL to be downloaded.

pszFileName

The name of the file on the local machine.

Return Value

Returns 1 if all files where downloaded successfully, otherwise 0.

isxdl_AddFile

Adds a file to the internal file list.

Syntax

void isxdl_AddFile(
	LPCTSTR	pszURL,
	LPCTSTR	pszFileName
);

isxdl_AddFileSize

Adds a file to the internal file list, and tells how big the file is. Use this if you know the size of the file, and know that it will not change. Means that the DLL won't have to find the size, which can take some time if you have many files to download.

Syntax

void isxdl_AddFileSize(
	LPCTSTR	pszURL,
	LPCTSTR	pszFileName,
	DWORD	dwSize
);

Parameters

pszURL

The URL to be downloaded.

pszFileName

The name of the file on the local machine.

dwSize

The size of the file.

Return Value

Returns nothing.

isxdl_DownloadFiles

Downloads all files added with isxdl_AddFile or isxdl_AddFileSize.

Syntax

int isxdl_DownloadFiles(
	HWND	hWndParent
);

Parameters

hWndParent

Handle to the parent window.

Return Value

Returns 1 if all files where downloaded successfully, otherwise 0.

isxdl_ClearFiles

Clears the internal file list. Shouldn't be necessary since files will be removed as they are successfully downloaded.

Syntax

void isxdl_ClearFiles(
);

Parameters

Return Value

Returns nothing.

isxdl_IsConnected

Tells wether the computer is connected to the Internet or not. This is kind of experimental, and very little tested.

Syntax

int isxdl_IsConnected(
);

Parameters

Return Value

Returns 1 if connected to the Internet, otherwise it returns 0.

isxdl_SetOption

Set various options.

Syntax

int isxdl_SetOption(
	LPCTSTR	pszOption,
	LPCTSTR	pszValue
);

Parameters

pszOption

The option to be modified.

pszValue

The value of the option. Note that this must always be given as a string.

Return Value

Returns 1 if the option was set successfully. Returns 0 if the option was unknown, or the option could not be set.

Remarks

Option	Value
title	The title to use for the download window.
debug	Not used. Valid values are "true" and "false".
simple	Turns on simple mode if the value is a string, turns off simple mode if the value is an empty string.
label	Text for header label.
description	Text for header description.
language	Language file to get texts from.
resume	Tell it to use resume. Default is true. (Disabled.)
smallwizardimage	The image to display if you want something other than the default.

isxdl_GetFileName

Get the real file name of a downloaded file. The URL to download ISTool is 'http://www.istool.org/getistool.aspx', and before downloading isxdl_GetFileName returns 'getistool.aspx'. After downloading, the result will be 'istool-5.0.6.1.exe'.

Syntax

LPCTSTR GetFileName(
	LPCTSTR pszURL
);

Parameters

pszURL

The URL to get the file name for.

Return Value

Returns the file name if the URL was found, otherwise returns NULL.