vuRunDelay(pFile, DelayMS)
vuRunDelay(*CSTRING pFile, LONG DelayMS), LONG
Description
Runs the specified file after waiting for a specified delay.
| 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(260) |
Full path to the file or executable to launch. |
| DelayMS |
LONG |
Delay before execution, in milliseconds (for example, 2000 = 2 seconds). |
Note: In vuFileTools V5, CSTRINGs are not limited to the size shown above. The number is for example only.
Returns
A LONG value indicating the result:
- 1 if the file was executed successfully after the delay
- 0 if the file could not be executed
- Negative values may indicate a Windows shell error
Example
FilePath CSTRING(260)
DelayMS LONG
Ret LONG
FilePath = 'C:\Windows\Notepad.exe'
DelayMS = 2000
Ret = vuRunDelay(FilePath, DelayMS)
MESSAGE('vuRunDelay returned: ' & FORMAT(Ret), 'vuRunDelay Test')
Notes
vuRunDelay is useful when you need a simple delayed launch and do not need separate parameters or a working folder.- Use
vuRunExDelay or vuRunExDelayWait when you need the same behavior with explicit file and parameter handling.