PathFind

InstallShield 2019 » InstallScript Language Reference

The PathFind function searches the path buffer for a specific directory. You can specify the directory with either a fully qualified path or the directory name only.

This function has no relationship to the path statement in the Autoexec.bat file or the path environment variable. It acts only on the path buffer, which helps you build, modify, and manipulate search paths. You can then add this temporary path string to the Autoexec.bat file using the various batch file functions.

Syntax

PathFind ( szDir, svResult, bDir, bSearch );

Parameters

PathFind Parameters

Parameter

Description

szDir

Specifies the path to find in the path buffer.

svResult

Returns the full directory and path found in the path buffer returned by the function.

bDir

Specifies whether or not szDir contains a fully qualified or an unqualified directory name. Pass one of the following predefined constants in this parameter:

FULL—szRefDir is a fully qualified path—it includes a drive designation and the complete path to a directory.
PARTIAL—szRefDir is the directory name only, without drive or path information.

bSearch

Specifies where to begin the search. Pass one of the following predefined constants in this parameter:

CONTINUE—Continues searching the path buffer at the location where the previous search was terminated.
RESTART—Starts the search from the beginning of the path buffer.

Return Values

PathFind Return Values

Return Value

Description

0

Indicates that the function successfully searched the path buffer for a directory.

< 0

Indicates that the function was unable to successfully search the path buffer for a directory.

See Also