Client-Side Communication ActionScript > NetConnection.call

NetConnection.call

Availability

	Flash Player 6.
	Flash Communication Server MX.

Usage

myConnection.call(remoteMethod, resultObject | null [, p1,...,pN])

Parameters

remoteMethod A parameter in the form [/objectPath/]method; if you are calling a method on a NetConnection object, you can omit objectPath. For example, the parameter /someObj/doSomething means the server must call the someObj.doSomething method of the application passed to NetConnection.connect in its targetURI parameter, passing the specified p1,...,pN parameters.

For security reasons, certain remoteMethod names are reserved at the application level; do not call these method names with the call method. The reserved names are /onConnect, /onDisconnect, /onStatus, /onAppStop, and /onAppStart.

resultObject An object parameter that is needed only when the sender is expecting a result. The result object can be any user-defined object. For it to be of use, a method named onResult must be called when the result arrives. If you don't need a result object, pass null.

p1,...pN Optional parameters to be passed to the specified method.

Returns

Nothing.

Description

Method; invokes a command or method on the server. You must create a server-side function to define this method. This method is also used when your application connects to an application server. For information on using Flash with an application server, see Using Flash Remoting.

Example

The following function checks for a message, sends it, then clears the local string.

function mySend()
{
	if (length(msg) > 0) {
		connection.call("message", null, msg);
	}
	msg = "";
}