wwHTTP::HTTPConnect

This HTTP method initiates a low level HTTP request for use with HTTPGetEx by establishing an IP Session and connecting to a target server. The main purpose of this method is to specify the server name and the security options when connecting.

Syntax:

o.httpconnect(lcServer, lcUsername, lcPassword, llHTTPS)

Return: 0 on success, an API error number on failure. Check cErrorMsg for an error string.

Parameters: All parameters are optional if the appropriate property names are set.
lcServer
Domain name or IP address of the server to connect to.
Examples: www.west-wind.com, 111.111.111.111
Note: Do not specify a URL here. This parameter should not include a protocol or port! Do not use http://www.west-wind.com/sompage.htm - if you want to specify a single URL use the HTTPGet() method.
Corresponds to cServer property.
lcUsername
Optional - A username that is used for Basic Authentication on the Web server.
Corresponds to cUsername property.
lcPassword
Optional - A password that is used for Basic Authentication on the Web server.
Corresponds to cPassword property.
Note: In order for Basic Authentication to work on the server it must be enabled there! Make sure you test this with a browser before trying this functionality programmatically.
llHTTPS
Optional - Requests to use the SSL/HTTPS protocol to connect to the server with encryption. Note: the server must have a secure certificate installed.
Corresponds to lSecureLink property.

Remarks: HTTPConnect() does not actually connect to the server - it builds a WinInet connection object only. The actual Web access doesn't occur until HTTPGetEx is actually called.
The nHTTPConnectMode property determines how the connection is created. The default is a direct connection, but you can also configure for Proxy or IE configurations.

Syntax:	o.httpconnect(lcServer, lcUsername, lcPassword, llHTTPS)
Return:	0 on success, an API error number on failure. Check cErrorMsg for an error string.
Parameters:	All parameters are optional if the appropriate property names are set. lcServer Domain name or IP address of the server to connect to. Examples: www.west-wind.com, 111.111.111.111 Note: Do not specify a URL here. This parameter should not include a protocol or port! Do not use http://www.west-wind.com/sompage.htm - if you want to specify a single URL use the HTTPGet() method. Corresponds to cServer property. lcUsername Optional - A username that is used for Basic Authentication on the Web server. Corresponds to cUsername property. lcPassword Optional - A password that is used for Basic Authentication on the Web server. Corresponds to cPassword property. Note: In order for Basic Authentication to work on the server it must be enabled there! Make sure you test this with a browser before trying this functionality programmatically. llHTTPS Optional - Requests to use the SSL/HTTPS protocol to connect to the server with encryption. Note: the server must have a secure certificate installed. Corresponds to lSecureLink property.
Remarks:	HTTPConnect() does not actually connect to the server - it builds a WinInet connection object only. The actual Web access doesn't occur until HTTPGetEx is actually called. The nHTTPConnectMode property determines how the connection is created. The default is a direct connection, but you can also configure for Proxy or IE configurations.