User Guide

42 Chapter 5: New FSCommand and FSCommand2 commands
2: There is currently no active network connection.
3: Network connection is in a suspended state.
4: The network connection is in an indeterminable state.
GetNetworkName()
The
GetNetworkName() function sets a parameter to the name of the current network. The
parameter is passed in by name. The value returned is a string representing the network name.
If no network is registered, the parameter containing the name is set to a zero-length string, and a
value of
0 is returned. If the network is registered but the name cannot be determined, the
parameter containing the name is set to a zero-length string, and a value of
1 is returned. If the
network is registered and its name can be determined, then the parameter containing the name is
set to be the network name, and a value of
2 is returned.
This function is executed immediately upon invocation. If
GetNetworkName() is not supported,
a value of
-1 is returned.
Syntax
status = FSCommand2( “GetNetworkName”, “networkname” )
Return value
A value of -1 if the function is not supported; otherwise, the following values are returned:
0: No network registered, and networkname is not set.
1: Network registered, but network name is not known; networkname is not set.
2: Network registered, and network name is known; networkname is set.
Sample resultant values for
networkname:
AT&T Wireless: Phone is currently on the AT&T Wireless network.
KPN Mobile: Phone is currently on the KPN Mobile network.
GetNetworkRequestStatus()
The
GetNetworkRequestStatus() function returns a value indicating the status of the most
recent HTTP request.
This function is executed immediately upon invocation. If
GetNetworkRequestStatus() is not
supported, a value of
-1 is returned.
Syntax
status = FSCommand2( "GetNetworkRequestStatus” )
Return value
A value of -1 if the function is not supported; otherwise, one of the following values:
0: There is a pending request, a network connection has been established, the server’s host name
has been resolved, and a connection to the server has been made.