EzConfigAddDriver

InstallShield 2019 » InstallScript Language Reference

The EzConfigAddDriver function adds a device driver statement to the default system configuration file. You can specify the position of the driver statement relative to another driver statement. For example, an application may require loading a device driver before or after the Windows Himem.sys driver.

Unless changed by a call to ConfigSetFileName, the default system configuration file is the Config.sys file that was executed by the system during the boot sequence. To make another file the default system configuration file, call ConfigSetFileName. To determine the fully qualified name of the default system configuration file, call ConfigGetFileName.

Note • Do not mix the Ez configuration file functions and the advanced configuration file functions. After calling ConfigFileLoad, you cannot call any of the Ez configuration file functions until you call ConfigFileSave to save the file.

Syntax

EzConfigAddDriver ( szDriver, szRefKey, nPosition );

Parameters

EzConfigAddDriver Parameters

Parameter

Description

szDriver

Specifies the fully qualified name of the driver to add to the file. If the driver already exists in one or more places in the system configuration file, this function replaces only the last occurrence of the line containing the driver.

szRefKey

Specifies the name of the device driver relative to which you are adding szDriver.

nPosition

Indicates whether szDriver is to be added before or after the driver specified by szRefKey. Pass one of the following predefined constants in this parameter:

•

BEFORE—The statement is added before the line containing szRefKey. If szRefKey contains a null string (""), the driver is inserted as the first driver in the system configuration file.

•

AFTER—The statement is added after the line containing szRefKey. If szRefKey contains a null string (""), the driver is inserted as the last driver in the system configuration file.

Return Values

EzConfigAddDriver Return Values
Return Value	Description
0	EzConfigAddDriver successfully added the device driver statement to the file.
< 0	EzConfigAddDriver was unable to add the driver statement.

EzConfigAddDriver

InstallShield 2019 Help Library

April 2019