Files

Enable Files virtual box - an enabled Virtual Box feature for files. The Files Virtual Box allow you to embed any kind of external files that your application uses for a single executable file. After the protection, you may delete all the files listed in Virtual Box, the application will work without them. Virtual Box supports any kind of embedded files, txt, dll (dll files will be correctly processed and initializated when the application requires them, ActiveX files will be registered at the file start), avi, mp3, bpl, ocx and many others.

Warning: it is not recommended to use the Virtual Box feature for the protection of the Dynamic Link Libraries (DLL) files. Only the DLLs called once at the start of the main executable file and never freed while the application is working can be protected with Virtual Box. The DLL files called/freed multiple times per one session should not be used in Virtual Box, because it may cause application crash.

Allow loading from any folder - embedded files can be sometimes called at an additional path that might not be specified upon the protection. If you enable this option, the Enigma loader will ignore the file's path.

Delete extracted files on exit - this works only with the files that have "Always Write to Disk" or "Write if not Present" actions. When the protected module is terminated, the Enigma loader will attempt to delete the extracted files from the disk.

Compress Files - enables compression of Virtual Box files. It is not recommended to use this option because it requires more memory to execute, increases execution time and decreases the protection of the Virtual Box files. The advantage is that it allows you to decrease the size of the file protected.

Click the Add button to add the files or folders into the list. There are the following adding functions available (all functions are also available through the right-click pop-up menu):

• Add File (s) - allows you to add a file or several files to the list. The files will be added to the currectly selected folder in the list;
• Add Files Recursive - allows you to add a folder with the files and sub folders. Each subfolder will be processed recursively;
• New Folder - allows you to create a new folder in the list. Note that folders of the first root node can only be from a pre-defined list of folders or a root folder of the drive. It is not recommended to use absolute paths (the absolute path is defined through the drive letter in the root of the list), use them only in cases when the relative path could not be used. Read more about pre-defined folders below.

To delete a file or a folder, select it and click the Delete button or press the Del key.

To Edit the file properties or folder name, select it and click the Edit button, or double-click the necessary item. Files Edit dialog looks like the one at the screen below and has the following options.

File Path - points to the real file that will be embedded. This file must exist. Click the Browse button to change the file.

Virtual Path - specifies the position of the file in the virtual files list. Note that a virtual path can be started from a pre-defined folder (relative path) or from a drive letter (absolute path). There are the following pre-defined folder names that can be used for a start of the Virtual Path:

• %DEFAULT FOLDER% - the folder where the protected module is placed;
• %SYSTEM FOLDER% - System32 (WinNt) or System (Win9X) subfolder of the Windows installation folder;
• %WINDOWS FOLDER% - the Windows installation folder;
• %My Documents FOLDER% - My Documents folder. Attention: For operating systems of Windows NT family there is an individual "My Documents" folder for each user;
• %My Pictures FOLDER% - My Pictures folder. It has the same warning as for My Documents folder;
• %Program Files FOLDER% - Program Files folder;
• %Program Files\Common FOLDER% - Program Files\Common folder;
• %AllUsers\Documents FOLDER% - All Users\Documents folder;
• %History FOLDER% - History folder. It has the same warning as for My Documents folder;
• %Cookies FOLDER% - Cookies folder. It has the same warning as for My Documents folder;
• %InternetCache FOLDER% - InternetCache folder. It has the same warning as for My Documents folder;
• %ApplicationData FOLDER% - ApplicationData folder. It has the same warning as for My Documents folder.

Examples:

• %DEFAULT FOLDER%\mydll.dll, means mydll.dll will be placed in the same folder with the protected file;
• %DEFAULT FOLDER%\data\intro.avi, the file will be placed in the data folder that is located in the same folder with the protected file;
• %SYSTEM FOLDER%\key.dat - the file will be placed in the system folder with name key.dat (for example, into folder c:\Windows\System32\)
• C:\myfile.key, it is an absolute path where the file will be located.

Register as ActiveX (COM) component - if the option is enabled, Enigma will try to register this file as ActiveX (COM) library at the file start.

Virtualization Method - specifies how the file will be processed: it will be either extracted to the disk when the protected file starts, or fully emulated in the memory. There are the following options available :

• Never Write to Disk- the embedded file will never be written to the disk. How it works: the Enigma loader hooks file access Windows API and checks if the API call points to the embedded file. You do not need to do any programming in order to use this function. If you have already got an application, just embed the necessary file and protect it. Moreover, if the embedded file is a dll, you may call any functions from this library without having it on the disk. The Enigma loader will initialize dll in the memory and successfully call the function required. If you use this feature, you do not need to place the embedded files with the protected module. Using this feature brings you a lot of benefits: your external library will not be stolen and used as a third party software, you protect embedded libraries from cracking and modifing, you may hide any types of files such as MP3, AVI, any image files, etc;
• Always Write to Disk - the embedded file will always be overwritten to the disk when the protected file starts;
• Write if not Present - the embedded file will be written to the disk if such a file does not exist.

Overwrite File Date/Time - enter the date and the time values that will be applied to the embedded file. If the option is not checked, the time settings of the real file will be used.

Overwrite File Attributes - specify the attributed file that will be applied to the protected file. If the option is not checked, attributes of the real file will be used.