This command returns the ID of a VHL file based on its filename. To to do, the command searches for a file whose configuration value VhlCfg.File.Filename matches the passed Filename exactly.
Use this ID to reference the VHL file in the following commands:
We strongly recommend you don't hardcode file IDs, but always resolve them via this command. Otherwise, your application won't work anymore if e.g. a project manager later merges VHL files into a different configuration using BALTECH ConfigEditor. This process may result in a new ID, but not in a new name.
Parameters (request frame)
|Length of FileName||Integer (8 bits)||
Length of FileName in bytes
Name of VHL file
The filename is case sensitive. Exactly 1 file with the given name must exist. If there are several or no files with exactly this name, VHL.ErrConfig is returned.
Returned values (response frame)
|Id||Integer (8 bits)||ID of VHL file|