Struct IProcessControl#

Inheritance Relationships#

Derived Type#

Struct Documentation#

struct IProcessControl#

Interface for process control. This interface is accessible by ‘main’ and ‘standalone’ applications only.

Subclassed by CProcessControl

Public Functions

virtual TProcessID Execute(const sdv::u8string &ssModule, const sdv::sequence<sdv::u8string> &seqArgs, EProcessRights eRights) = 0#

Execute a process.

Parameters:

  • ssModule – [in] Module name of the process executable.

  • seqArgs – [in] Instantiation arguments to supply to the process.

  • eRights – [in] The process rights during instantiation.

Returns:

Returns the process ID or 0 when process creation failed.

virtual bool Terminate(TProcessID tProcessID) = 0#

Terminate the process.

Attention

Use this function as a last resort only. The process will be killed and anything unsaved will render invalid.

Parameters:

tProcessID – [in] The process ID of the process to terminate.

Returns:

Returns ‘true’ if termination was successful; returns ‘false’ if termination was not possible or not allowed.

TProcessID Execute (in u8string ssModule, in sequence< u8string > seqArgs, in EProcessRights eRights)

Execute a process.

Parameters:

  • ssModule – [in] Module name of the process executable.

  • seqArgs – [in] Instantiation arguments to supply to the process.

  • eRights – [in] The process rights during instantiation.

Returns:

Returns the process ID or 0 when process creation failed.

boolean Terminate (in TProcessID tProcessID)

Terminate the process.

Attention

Use this function as a last resort only. The process will be killed and anything unsaved will render invalid.

Parameters:

tProcessID – [in] The process ID of the process to terminate.

Returns:

Returns ‘true’ if termination was successful; returns ‘false’ if termination was not possible or not allowed.

Public Static Attributes

static ::sdv::interface_id _id = 0x8B3DBE60232F8394#

Interface ID.