interface XSystemShellExecute in module com::sun::star::system::

(Global Index)

Syntax

interface XSystemShellExecute : com::sun::star::uno::XInterface ;

Description

Specifies an interface for executing a system command.

Method Summary

execute Executes an abitrary system command.

Known Services Which Export this Interface

com::sun::star::system::SystemShellExecute

Method Details



execute

Syntax

void execute (
string aCommand,
string aParameter,
long nFlags )
raises ( com::sun::star::lang::IllegalArgumentException , com::sun::star::system::SystemShellExecuteException );

Description

Executes an abitrary system command.

Parameter aCommand

Specifies the command to execute. This may be an executable file or a document which is registered with an application on a specific platform, so that the platform knows what application to launch for that document. If the command specifies a path to an executable, etc, this has to be a system specific path.

Parameter aParameter

Specifies a list of space separated parameters. The method does not validate the given parameters, but only passes it as a parameter to the specified command.

Parameter nFlags

Specifies different flags to control the execution of this method, for example, avoid showing system error messages, in case of failures, etc.

Throws

com::sun::star::lang::IllegalArgumentException when the specified flags are wrong or exclude each other. .

Throws

com::sun::star::sys::SystemExecuteException in the case of errors when trying to executed the specified command.

See also

SystemShellExecuteFlags
Top of Page