docs

Home All functions Categories

vuShellDelay(pFile, DelayMS)

vuShellDelay(*CSTRING pFile, LONG DelayMS), LONG

Description

Launches a file using the Windows shell after waiting for a specified delay.

Function Separate File/Params Working Folder Delay Wait Notes
vuShell No No No No Simple shell launch that honors Windows file associations.
vuShellDelay No No Yes No Shell launch after a startup delay.
vuShellEx Yes Yes No No Preferred shell launch when you want file and parameters passed separately.
vuShellExDelay Yes Yes Yes No Shell launch with separate parameters plus startup delay.

Parameters

Parameter Data Type Description
pFile *CSTRING Full path to the file or executable to launch.
DelayMS LONG Delay before launching, in milliseconds.

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)
DelayMS  LONG
Ret      LONG

FilePath = 'C:\Temp\Readme.txt'
DelayMS  = 2000
Ret = vuShellDelay(FilePath, DelayMS)

Notes

Home All functions Categories