|

Message


(string) Either a blank string ("") or an information message being sent by the server, such as "Resolving host name" or "Connecting to Server."


image

Note: If this parameter is not a blank string, it means that it is in a busy state, either before the download has begun, or at the end of the download. In this case all other parameters will be ignored.


The callback function should return a boolean value (true or false) indicating whether the download should continue:



VALUE DESCRIPTION


true


Continue with the file download.


false


Stop the file download as soon as possible.


Re t u r n s


Nothing. You can use Application.GetLastError to determine whether this action failed, and why.


See also: Related Actions


image

image

HTTP.GetConnectionState

OverviewExamples

table HTTP.GetConnectionState ( )


De s cr ip t ion


image

Retrieves the connected state of the local system.


Note: This action requires that the end user has Internet Explorer version 4.0 or greater installed.


image

Note: You cannot rely solely on the fact that the Connected result of HTTP.GetConnectionState returning true means that you have a valid active Internet connection. It is impossible for HTTP.GetConnectionState to determine if the entire connection to the Internet is functioning without sending a request to a server. This is why you need to send a request to determine if you are really connected or not. You can be assured however that if the Connected value of HTTP.GetConnectionState returns true, that attempting your connection will NOT cause you to be prompted to connect to the default Internet Service Provider.


P arame t er s


None.


Re t u r n s


image

(table) A table containing the user's Internet connection information, indexed by the following categories:


Note: If the user has a version of Internet Explorer that is less than 4.0, nil will be returned.



KEY


TYPE DESCRIPTION


Connected


boolean


Whether or not the user is connected to the Internet. If the user is connected, true is returned. If they are not connected, false is returned. You can access this value using tb.Connected.


Modem


boolean


Whether or not the local system uses a modem to connect to the Internet. If a modem is used, true is returned. If a modem is not used, false is returned. You can access this value using tb.Modem.


LAN


boolean


Whether or not the local system uses a local area network to connect to the Internet. If a LAN is used, true is returned. If a LAN is not used, false is returned. You can access this value using tb.Lan.


Proxy


boolean


Whether or not the local system uses a proxy server to connect to the Internet. If a proxy server is used, true is returned. If a proxy server is not used, false is returned. You can access this value using tb.Proxy.


RASInstalled


boolean


Whether or not the local system has RAS (Remote Access Service) installed. If a RAS is installed, true is returned. If RAS is not installed, false is returned. You can access this value using tb.RASInstalled.


ConnectionOffline


boolean


Whether or not the local system is in offline mode. If the system is offline, true is returned. If the system is not offline, false is returned. You can access this value using tb.ConnectionOffline.


ConnectionConfigured


boolean


Whether or not the local system has a valid connection to the Internet, but it might or might not be currently connected. If the system has a valid connection, true is returned. If the


system does not have a valid connection, false is returned. You can access this value using tb.ConnectionConfigured.


image

You can use Application.GetLastError to determine whether this action failed, and why.


|