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)

Name Type/Size Description
Length of FileName Integer (8 bits) Length of FileName in bytes
FileName ASCII string 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)

Name Type/Size Description
Id Integer (8 bits) ID of VHL file