BrightSign Object Reference Manual (FW 5.1) User Manual
Page 252
244
associated with the object A False return indicates that the request could not be issued and no events will be
delivered.
•
SetUserAndPassword(user As String, password As String) As Boolean: Enables HTTP
authentication using the specified user name and password. Note that HTTP basic authentication is deliberately
disabled due to it being inherently insecure. HTTP digest authentication is supported.
•
SetMinimumTransferRate(bytes_per_second As Integer, period_in_seconds As Integer) As
Boolean: Causes the transfer to be terminated if the rate drops below bytes_per_second when averaged
over period_in_seconds. Note that if the transfer is over the Internet, you may not want to set period_in_seconds
to a small number in case network problems cause temporary drops in performance. For large file transfers and a
small bytes_per_second limit, averaging fifteen minutes or more might be appropriate.
•
GetFailureReason As String: May provide additional information if any of the roUrlTransfer methods indicate
failure.
•
SetHeaders(a As Object) As Boolean
•
AsyncGetToObject(type As String) As Boolean: Begins an asynchronious GET request and uses the
contents to create an object of the specified type. Events will be sent to the message port associated with the
object. If this method returns False, the request could not be issued and no events will be delievered.
•
AsyncCancel() As Boolean
•
EnableUnsafeAuthentication(enable As Boolean) As Boolean: Supports basic HTTP authentication if
True. HTTP authentication uses an insecure protocol, which might allow others to easily determine the password.
The roUrlTransfer object will still prefer the stronger digest HTTP if it is supported by the server. If this method is
False (which is the default setting), it will refuse to provide passwords via basic HTTP authentication, and any
requests requiring this authentication will fail.
•
EnableUnsafeProxyAuthentication(enable As Boolean) As Boolean: Supports basic HTTP
authentication against proxies if True (which, unlike
EnableUnsafeAuthentication(), is the default setting).
HTTP authentication uses an insecure protocol, which might allow others to easily determine the password. If this
method is False, it will refuse to provide passwords via basic HTTP authentication, and any requests requiring this
authentication type will fail.