Home / Autodocs / datatypes.library
NAME
- LaunchToolA
-
invoke a given tool with project (V45)
SYNOPSIS
success = LaunchToolA( tool, project, attrs );
d0 a0 a1 a2
ULONG LaunchToolA( struct Tool *, STRPTR, struct TagItem * );
success = LaunchTool( tool, project, tag1, ... );
ULONG LaunchTool( struct Tool *, STRPTR, ... );
d0 a0 a1 a2
ULONG LaunchToolA( struct Tool *, STRPTR, struct TagItem * );
success = LaunchTool( tool, project, tag1, ... );
ULONG LaunchTool( struct Tool *, STRPTR, ... );
FUNCTION
This function launches an application with a specified project. The application and its launch mode and other attributes are specified through the "Tool" structure.
INPUTS
- tool
-
Pointer to a Tool structure. NULL is a valid arg.
- project
-
Name of the project to execute or NULL.
- attrs
-
Additional attributes.
TAGS
- NP_Priority (BYTE)
-
sets the priority of the launched tool Defaults to the current process's priority for Shell and ARexx programs; Workbench applications defaults to 0 except overridden by the TOOLPRI tooltype.
- NP_Synchronous (BOOL)
-
don't return until lauched application process finishes. Defaults to FALSE. Also see 'NOTE' below.
RESULT
FALSE for failure, non-zero for success.
EXAMPLE
NOTES
-
This function requires the "RX" command when lauching ARexx scripts.
-
This function must be launched from a process, not a simple task.
-
This function is not limited to use the struct DataType->dtn_Tools tools. Applications can set up their own struct Tool's as long as these structures contains no rubbish. If you don't know the TW_#? ("which") type of your custom tool, set tn_Which to TW_MISC.
-
The NP_Synchronous tag has been removed from dos/dostags.h in v51 because dos.library never supported this feature. In v51.8+ of datatypes.library SYS_Asynch can be used instead.
BUGS
-
The path of the launched tools depends on the parents path. If there is no path, shell tools can only launch other tools with their full path.