ConfigSetFileName

InstallShield 2019 » InstallScript Language Reference

The ConfigSetFileName function specifies the fully qualified name of the file you want to use as the default system configuration file. During installation initialization, the installation identifies the Config.sys file that was executed when the target system was started and makes it the default system configuration file. If this is the only system configuration file your installation will edit, it is unnecessary to call this function. Ez configuration files will use that file and the advanced configuration function ConfigFileLoad will open that file when its parameter is a null string ("").

However, if you want to use Ez configuration file functions to modify a configuration file other than the bootup Config.sys file, you must call ConfigSetFileName to change the default system configuration file. For example, suppose you wanted to create a Config.sys file on the target system that would not be used at bootup time. You can set a file name in the application directory. Ez configuration file functions would operate on that file. If you call ConfigFileLoad with a null parameter, that file is loaded into memory, where it can be edited with advanced file functions.

Caution • The ConfigSetFileName function does not load a system configuration file into memory. You must use ConfigFileLoad to load a file into memory.

ConfigSetFileName does not validate the file name you specify. If you specify an invalid file name, all future configuration file functions fail.

Note • Do not mix the Ez configuration file functions with the advanced configuration file functions. After calling the ConfigFileLoad function, you cannot use the Ez configuration file functions until you use the ConfigFileSave function to save your changes.

Syntax

ConfigSetFileName ( szConfigFile );

Parameters

Return Values

See Also

ConfigSetFileName Example

ConfigDelete

ConfigFind

ConfigMove

ConfigGetFileName

Open topic with navigation