Roku Object Reference - imaginArt

oNetworkConfiguration ()
Object creation:
• CreateObject("roNetworkConfiguration", 0)
The ifNetworkConfiguration interface provides (methods do not take effect until Apply is called):
• SetDHCP(key As String, value As Object) As Void
o Enable DHCP. Disables all other settings.
• SetIP4Address(ip As String) As Boolean
• SetIP4Netmask(netmask As String) As Boolean
• SetIP4Broadcast(broadcast As String) As Boolean
• SetIP4Gateway(gateway As String) As Boolean
o Set IPv4 interface configuration. All values must be set – no cleverness is applied (unlike
ifconfig shell command). Parameter is a string dotted decimal quad (i.e. “192.168.1.2” or
similar). Returns true on success.
o Example
nc.SetIP4Address("192.168.1.42")
nc.SetIP4Netmask("255.255.255.0")
nc.SetIP4Broadcast("192.168.1.255")
nc.SetIP4Gateway("192.168.1.1")
• SetDomain(domain As String) As Boolean
o Set the device domain name. This will be appended to names to fully qualify them. It is not
necessary to call this. Returns true on success.
o Example
nc.SetDomain("roku.com")
• AddDNSServer(server As String) As Void
o When the object is created there are no DNS servers, this adds another server to the list. There
is currently a maximum of three but adding more will not fail. Returns true on success. There
is no way to remove all the servers, just re-create the object.
• GetFailureReason() As String
o Give more information when a member function has returned false.
• Apply() As Boolean
o Apply the requested changes to the network interface. This may take several seconds to
complete.
• SetTimeServer(time_server As String) As Boolean
o The default time server is “time.rokulabs.com”. The use of NTP can be disabled by calling
SetTimerServer(“”).
55