HTTPSGetFile (ImageKit Control/File Method)

This method retrieves a file from the HTTPS server. (It includes connecting to and disconnecting from the server.)

[Visual Basic] [ Boolean = ]imagekitcontrolname.File.HTTPSGetFile(ServerName As String, ProxyName As String, PortNo As Integer, RemoteFilePath As String, UserName As String, Password As String, TransPercent As Long)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetFile().HTTPSGetFile(LPCTSTR ServerName, LPCTSTR ProxyName, short PortNo, LPCTSTR RemoteFilePath, LPCTSTR UserName, LPCTSTR Password, long TransPercent)

[VB.NET] [ Boolean = ]imagekitcontrolname.File.HTTPSGetFile(ServerName As String, ProxyName As String, PortNo As Short, RemoteFilePath As String, UserName As String, Password As String, TransPercent As Integer)

[C#.NET] [ bool = ]imagekitcontrolname.File.HTTPSGetFile(string ServerName, string ProxyName, short PortNo, string RemoteFilePath, string UserName, string Password, int TransPercent)

Parameters

Name	Explanation
ServerName	The name of the HTTPS server or IPAddress
ProxyName	The Proxy Server IP Address
PortNo	Port Number (default is 443)
RemoteFilePath	The name and path of the file to be retrieved
UserName	The username needed to access the HTTPS server
Password	The password needed to access the HTTPS server
TransPercent	The percentage of the file that is tranferred before the ImageKit Progress event is generated

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The HTTPSGetFile method retrieves a file from the HTTPS server. (It includes connecting to and disconnecting from the server.) This method can only be executed from the client computer. It does not operate on the server. The TransPercent parameter sets the amount of transfer in percentage before the ImageKit Progress event fires. For example, if the TransPercent = 10, the ImageKit Progress event will fire 10 times, 1 time for each 10% of file transferred.

The retrieved file is saved in the location specified by the FileName property.

When not using a proxy server set the ProxyName to an empty string, to vbNullString(Visual Basic), to NULL(Visual C++), to Nothing(VB.NET), or null(C#.NET).