Top   Module   Use   Manual   Index 
 EXPORTING SERVICES | METHODS' SUMMARY | METHODS' DETAILS 

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

interface XSystemShellExecute

Base Interface
com::sun::star::uno::XInterface

Description
Specifies an interface for executing a system command.


Known Services which Export this Interface

com::sun::star::system::SystemShellExecute Specifies a system executer service. Such a service makes it possible to execute an arbitrary system command.

Methods' Summary

execute Executes an abitrary system command.

Methods' Details

execute
 
void
execute(
[ in ] string aCommand,
[ in ] string aParameter,
[ in ] 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
com::sun::star::system::SystemShellExecuteFlags

Top of Page