DIFxDriverPackageGetPath

InstallShield 2016 » InstallScript Language Reference

Project • This function applies to InstallScript projects only. This function is not required in InstallScript MSI projects since DIFx can be called by the Windows Installer in those projects.

The DIFxDriverPackageGetPath function retrieves the fully qualified path to a driver store .inf file.

Note • This function calls the DIFxAPI function DriverPackageGetPath. See the DIFxAPI documentation for additional details regarding this function and its parameters and return values.

Syntax

DIFxDriverPackageGetPath( byval string szDriverPackageInfPath, byref string svDestInfPath, byval number nISFlags );

Parameters

DIFxDriverPackageGetPath Parameters

Parameter

Description

szDriverPackageInfPath

Specifies the fully qualified path to a driver package .inf file for which to retrieve the corresponding driver store .inf file.

svDestInfPath

Specifies the fully qualified path of the driver store .inf file that corresponds to the driver package .inf file supplied by DriverPackageInfPath.

nISFlags

Specifies InstallScript-specific flags. The following flags are available:

0—Default behavior
ISDIFX_OPTION_DONT_RESOLVE_TEXTSUBS—By default, the function resolves any text substitutions found in szDriverPackageInfPath. However, if this flag is specified, text substitutions are not resolved.

Return Values

DIFxDriverPackageGetPath Return Values

Return Value

Description

ISERR_SUCCESS

The function was successful.

< ISERR_SUCCESS

The function failed.

If the return value from DriverPackageGetPath is a Win32 error (a positive return value), ISERR_WIN_BASE is added to the error to ensure that it is < ISERR_SUCCESS.

You can use the following code to get the original Win32 error, if desired:

if( nResult & ISERR_WIN_BASE ) then

nResult = nResult - ISERR_WIN_BASE;

endif;

For a list of specific errors, see DIFxAPI Errors (InstallScript Projects).

Additional Information

For more information on DIFx and DIFxAPI, see the MSDN Library.