Macromedia flash mx professional 2004-macromedia flash lite 1.1 authoring guidelines Benutzerhandbuch

Seite von 86
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.