docs

Home All functions Categories

vuRunExists(pFile)

vuRunExists(*CSTRING pFile), LONG

Description

Attempts to run the specified file if it exists.

Function Separate File/Params Working Folder Delay Wait Notes
vuRun No No No Yes Single command-line string. Good for simple or legacy launches.
vuRunDelay No No Yes No Single command-line string with a startup delay.
vuRunEx Yes Yes No No Preferred modern launch when you want file and parameters passed separately.
vuRunExWait Yes Yes No Yes Preferred modern launch with separate parameters and optional wait.
vuRunExDelay Yes Yes Yes No Modern launch with separate parameters plus startup delay.
vuRunExDelayWait Yes Yes Yes Yes Modern launch with separate parameters, startup delay, and optional wait.
vuRunExists No No No No Runs only if the target file already exists.
vuRunExistsEx No No Polls for file No Waits for a file to appear, then runs it.

Parameters

Parameter Data Type Description
pFile *CSTRING Full path to the file or executable to run.

CSTRING size note: CSTRING(1024) in this example is a caller-side declaration, not an unlimited-length guarantee. This function copies the relevant path, parameter, or working-folder text into internal 1,024-byte null-terminated buffer(s), so each copied value must fit (up to 1,023 characters plus its null byte). Longer input may be truncated; Windows can impose additional restrictions. See CSTRING Sizes and Buffer Capacity.

Returns

A LONG value indicating the result:

Example

FilePath CSTRING(1024)
Ret      LONG

FilePath = 'C:\Temp\MyReport.pdf'
Ret = vuRunExists(FilePath)

Notes

Home All functions Categories