You are here: Start » Function Reference » All Functions » Process » AvsFilter_Execute_StartOnly_Deprecated

AvsFilter_Execute_StartOnly_Deprecated

This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Header:	STD.h
Namespace:	avs
Module:	FoundationLite

Executes a command using the system console and returns immediately.

Syntax

void avs::AvsFilter_Execute_StartOnly_Deprecated
(
	const atl::File& inCommand,
	const atl::Array<atl::String>& inArguments,
	const atl::Directory& inWorkingDirectory
)

Parameters

Name	Type	Default	Description
inCommand	const File&		System command to be executed.
inArguments	const Array<String>&		Arguments for the command.
inWorkingDirectory	const Directory&	\".\"	Working directory in which the command will be executed.

Description

Filter executes a command provided in inCommand with inArguments arguments. The command will be executed in a directory provided in inWorkingDirectory.

Note: inCommand needs to be an executable file, in contrast to AvsFilter_Execute_WaitForExit_Deprecated where it could also be a shell builtin.

Program execution is not blocked: filter does not wait for command completion.

Remarks

Usage of this filter is not recommended in AVL.

Errors

List of possible exceptions:

Error type	Description
DomainError	Could not remember current working directory.
DomainError	Provided inWorkingDirectory is incorrect or not found. Path: provided working directory
DomainError	Provided inWorkingDirectory user provided directory is incorrect or not found.
RuntimeError	Could not return from working directory.
RuntimeError	Could not start process