MACROMEDIA FLASH MEDIA SERVER 2-SERVER MANAGEMENT ACTIONSCRIPT..., Справочник

Страница: 63 / 74

setConfig() 63
■
For the Application.xml file of an application that is running on the same virtual host to
which you connected when you logged on to the administration server, specify as the first
subkey
Application: app_name
, where
app_name
is the name of the application.
To get a key in the Application.xml file for an application that is running on a different
virtual host, specify the full key:
Adaptor: adaptor_name /VirtualHost: vhost_name /
Application: app_name
. You must also specify the
scope
parameter; see the code
example later in this entry.
To get the default Application.xml file, specify
Application
without the colon (:) and the
app_name
attribute.
key_value
String; the value to set for the specified configuration key.
scope
String; to change a configuration key in the Server.xml file, Adaptor.xml file, or
Vhost.xml files, you must specify a slash (
/
) for this parameter.
To change a configuration key in the Application.xml file for an application that is running
on the same virtual host to which you connected when you logged on to Flash Media Server,
omit this parameter.
Returns
If the call succeeds, the server sends a reply information object with a
level
property of
status
and a
code
property of
NetConnection.Call.Success
. The value of the
configuration key is changed.
If the call fails, the server sends a reply information object with a
level
property of
error
, a
code
property of
NetConnection.Call.BadValue
, and a
description
property that
contains a string describing the cause of the failure.
This call fails if the specified configuration key cannot be found or if you do not have
permissions to change its value.
Description
This API has been deprecated; use
setConfig2()
instead. Changes the value of the specified
configuration key in a specified configuration file. Flash Media Server has four server
configuration files: Server.xml, Adaptor.xml, Vhost.xml, and Application.xml.
Virtual host administrators can change the values of configuration keys in the Vhost.xml file
and Application.xml files for their own virtual hosts.
NO
TE
If a subkey is specified but a corresponding tag doesn’t exist in the XML file, a new
tag is created in the XML file.
TIP
To determine the adaptor or virtual host to which you’re connected, use the
getAdminContext
method.