SysProcessCreate2 (FUN) ¶ FUNCTION SysProcessCreate2 : RTS_IEC_HANDLE <description>Function to create a process. NOTE: Is only available on systems with processes! This functions creates and eventually starts a new process for the specified application. The properties of the created process can be defined by appropriate flags.</description> <result><p>RESULT: Handle to the created process or RTS_INVALID_HANDLE if failed.</p></result> InOut: Scope Name Type Comment Return SysProcessCreate2 RTS_IEC_HANDLE Input pszApplication REFERENCE TO STRING <param name=”pszApplication” type=”IN”>Name of application to start as a separate process</param> pszCommandLine REFERENCE TO STRING <param name=”pszCommandLine” type=”IN”>String with the command line</param> ulFlags UDINT <param name=”ulFlags” type=”IN”>A combination of the process flags SYSPROCESS_CREATEFLAG_XXX.</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>

SysProcessExecuteCommand (FUN) ¶ FUNCTION SysProcessExecuteCommand : DINT <description>Function to start a system command. The command is operating system dependent!</description> <result><p>RESULT: Result of command after execution</p></result> InOut: Scope Name Type Comment Return SysProcessExecuteCommand DINT Input pszComand REFERENCE TO STRING <param name=”pszCommand” type=”IN”>Command line parameters to be transmitted to application at execution</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>

SysProcessExecuteCommand2 (FUN) ¶ FUNCTION SysProcessExecuteCommand2 : DINT <description>Function to start a system command. The command is operating system dependent! Command will be executed, only if allowed (see settings for details). Output of the executed command will be filled into pszStdOut. </description> <result><p>RESULT: Number of bytes, read from the commands output.</p></result> InOut: Scope Name Type Comment Return SysProcessExecuteCommand2 DINT Input pszCommand REFERENCE TO STRING <param name=”pszCommand” type=”IN”>Command line parameters to be transmitted to application at execution</param> pszStdOut REFERENCE TO STRING <param name=”pszStdOut” type=”IN”>Buffer for StdOut string</param> udiStdOutLen UDINT <param name=”udiStdOutLen” type=”IN”>Buffersize for StdOut string buffer</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code. ERR_PARAMETER: if pszCommand, pszStdOut or udiStdOutLen is null, ERR_NO_ACCESS_RIGHTS: if command is not allowed</param>

SysProcessFreeHandle (FUN) ¶ FUNCTION SysProcessFreeHandle : RTS_IEC_RESULT <description>Function to release the process handle that is returned by SysProcessCreate or SysProcessGetCurrentHandle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessFreeHandle RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param>

SysProcessGetCurrentHandle (FUN) ¶ FUNCTION SysProcessGetCurrentHandle : RTS_IEC_HANDLE <description>Function to get a handle to the current process</description> <result><p>RESULT: Returns the handle of the process actually running by the processor or RTS_INVALID_HANDLE if failed.</p></result> InOut: Scope Name Type Comment Return SysProcessGetCurrentHandle RTS_IEC_HANDLE Input pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>

SysProcessGetOSId (FUN) ¶ FUNCTION SysProcessGetOSId : UDINT <description>Function to determine an operating system dependent identification of a process. This identification must be unique in the system at a defined time! SysProcessGetOSId can only applied to the process actually executed or to processes having been generated by SysProcessCreate.</description> <result><p>RESULT: Returns the operating system specific identification of the process</p></result> InOut: Scope Name Type Comment Return SysProcessGetOSId UDINT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pResult POINTER TO RTS_IEC_RESULT <param name=”pResult” type=”OUT”>Pointer to runtime system error code (see CmpErrors.library)</param>

SysProcessGetPriority (FUN) ¶ FUNCTION SysProcessGetPriority : RTS_IEC_RESULT <description>This function retrieves the priority of the process specified by its handle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessGetPriority RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pulPriority POINTER TO UDINT <param name=”pulPriority” type=”OUT”>Pointer to variable being assigned to priority of the process</param>

SysProcessGetState (FUN) ¶ FUNCTION SysProcessGetState : RTS_IEC_RESULT <description>This function retrieves the status of the process specified by its handle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessGetState RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> pulState POINTER TO UDINT <param name=”pulState” type=”OUT”>Pointer to variable being assigned to value 1 for running processes and value 2 for terminated processes</param>

SysProcessResume (FUN) ¶ FUNCTION SysProcessResume : RTS_IEC_RESULT <description>This function starts the process specified by its handle. For example, the function can be used for processes having been created in suspended mode by use of the flag SYSPROCESS_CREATEFLAG_CREATESUSPENDED.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessResume RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param>

SysProcessSetPriority (FUN) ¶ FUNCTION SysProcessSetPriority : RTS_IEC_RESULT <description>This function sets the priority of the process specified by its handle.</description> <result><p>RESULT: Returns the runtime system error code (see CmpErrors.library).</p></result> InOut: Scope Name Type Comment Return SysProcessSetPriority RTS_IEC_RESULT Input hProcess RTS_IEC_HANDLE <param name=”hProcess” type=”IN”>Handle of the process</param> ulPriority UDINT <param name=”ulPriority” type=”IN”>Process priority</param>