StandaloneConfigOpen
This reference collection includes Vector documentation reproduced with permission. Snippets may require configuration-specific symbols and are not all standalone programs. Sources and validation limits.
Syntax
dword StandaloneConfigOpen(CHAR rtcfgFileName[], dword stopCurrentMeasurement, dword startNewMeasurement, dword returnToActiveConfig)
Function
Opens theRTCFGfile with the given name as standalone configuration.
Parameters
rtcfgFileName Name of the standalone configuration file (without path) to be set as default file.
stopCurrentMeasurement If this parameter is 1 measurement is stopped immediately (but still waiting for deferred stop clients). If the parameter value is 0 the request to load another configuration is queued until end of measurement.
startNewMeasurement If this parameter is set to 1 measurement will start immediately after the new configuration has been loaded.
returnToActiveConfig
If this parameter is set to 1 the default configuration (usually a sort of “master configuration”) will be loaded automatically after measurement based on the new configuration will have been stopped.
Return Values
The function returns an error code with 0 representing successful operation.
Reference example from the CANoe 12 help. Check the required configuration, database objects and API availability in your installed version; this is not a recorded compiler or runtime test.
// "Config1.RTCFG" (master config.) contains following CAPL code:
on key F2
{
StandaloneConfigOpen("Config2.RTCFG", 1, 1, 1);
}
on key F3
{
StandaloneConfigOpen("Config3.RTCFG", 1, 0, 1);
}