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.

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.

File Properties

To Edit the file or folder properties, select it and click the Edit button, or double-click the necessary item.

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% - folder where the protected module is located;
• %SYSTEM FOLDER% - System32 (WinNt) or System (Win9X) subfolder of the Windows installation folder;
• %WINDOWS FOLDER% - Windows installation folder;
• %My Documents FOLDER% - My Documents folder. Attention: For operating systems of Windows NT family there are individual "My Documents" folders for each user;
• %My Pictures FOLDER% - My Pictures folder. It has same warning as for My Documents folder;
• %Program Files FOLDER% - Program Files folder;
• %Program Files, Common FOLDER% - Program Files\Common folder;
• %AllUsers, Documents FOLDER% - AllUsers\Documents folder;
• %History FOLDER% - History folder. It has same warning as for My Documents folder;
• %Cookies FOLDER% - Cookies folder. It has same warning as for My Documents folder;
• %InternetCache FOLDER% - InternetCache folder. It has same warning as for My Documents folder;
• %ApplicationData FOLDER% - Application Data folder. It has same warning as for My Documents folder.
• %Temp FOLDER% - Temporary folder;
• %AllUsers, ApplicationData FOLDER% - AllUsers\Application Data folder;
• %Local, ApplicationData FOLDER% - LocalSettings\Application Data 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 Virtual Box will try to register this file as a ActiveX (COM) library at file start. Please note, if the file will be run without administrator privileges then the registry access may be limited, and attempt to register ActiveX component in real registry will fail. To avoid it, enable Registry Virtualization and make sure HKEY_CLASSES_ROOT key is virtual, so all registry changes (changes are being performed while ActiveX registration) are done in virtual registry only, without care of administrator privileges.

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;
• Never Write to Disk, Use File from Disk (if Exists) - embedded file will never be written to disk, it will be emulated in process memory. However, if the file with the same name, will exist in the same folder on the disk, the file from the disk will be used.

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

Overwrite File Attributes - specify attributes for virtual file. If option is not checked, attributes of real file are used.

Hide files and folders from File Open/Save dialogs - Available in Enigma Protector only.

Folder Properties

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

Overwrite File Date/Time - enter the date and the time values that will be applied to this folder

Overwrite File Attributes - specify attributes for virtual folder

New Content in Folder - determines the behavior of virtualization system if application attempts to create new files and folders within virtual folder, it can be either:

• New Folders and Files Become Real
- new files and folders will be written to disk;
• New Folders Become Real but Files Virtual
- new folder will be written to disk, but files enumated in memory;
• New Folders Become Virtual but Files Real
- new folders will be enumated in memory, but files written to disk;
• New Folder and Files Become Virtual
- new files and folders will be emulated in memory;

Hide files and folders from File Open/Save dialogs - disables file enumeration for system functions. Enumeration, apart of File Open/Save dialogs is used by crackers to identify virtual files and possible extract them. To avoid that, it is recommended to use this option for as many files as possible, until the application keeps stable. Please note, this option has critical incompatibility with particular files, so it can't be used for them;

Apply same properties for all child folders and properties recursively - assigns same properties to all nested files and folders