LibreOffice
LibreOffice 7.4 SDK API Reference
Public Member Functions | List of all members
XSystemShellExecute Interface Referencepublished

Specifies an interface for executing a system command. More...

import"XSystemShellExecute.idl";

Inheritance diagram for XSystemShellExecute:
XInterface SystemShellExecute

Public Member Functions

void execute ([in] string aCommand, [in] string aParameter, [in] long nFlags) raises ( ::com::sun::star::lang::IllegalArgumentException, ::com::sun::star::system::SystemShellExecuteException )
 Executes an arbitrary system command. More...
 
- Public Member Functions inherited from XInterface
any queryInterface ([in] type aType)
 queries for a new interface to an existing UNO object. More...
 
void acquire ()
 increases the reference counter by one. More...
 
void release ()
 decreases the reference counter by one. More...
 

Detailed Description

Specifies an interface for executing a system command.

Member Function Documentation

◆ execute()

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

Executes an arbitrary system command.

Parameters
aCommandSpecifies 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.
aParameterSpecifies 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.
nFlagsSpecifies different flags to control the execution of this method, for example, avoid showing system error messages, in case of failures, etc.
Exceptions
com::sun::star::lang::IllegalArgumentExceptionwhen the specified flags are wrong or exclude each other; also thrown, with an ArgumentPosition of 0, when nFlags contains URIS_ONLY and aCommand is not an absolute URI reference
com::sun::star::system::SystemShellExecuteExceptionin the case of errors when trying to executed the specified command.
See also
com::sun::star::system::SystemShellExecuteFlags

The documentation for this interface was generated from the following file: