VMProtect

https://vmpsoft.com/vmprotect/user-manual
Admin
VMProtect is a software protection utility that uses virtualization, mutation, and obfuscation...
Tokens:62,615
Snippets:439
Trust Score:5.4
Update:13 hours ago
Show doc for...
Tokens:
Raw
### Assembly prologue and epilogue example

Source: https://vmpsoft.com/vmprotect/user-manual

Shows the typical prologue and epilogue of a compiled function, which are not included when using code markers. This is used to illustrate a potential security weakness.

```php
push ebp      \
mov ebp, esp   \ prologue
push 00        / 
push ebx      /
...
pop ebx       \
pop ecx        \ epilogue
pop ebp        /
ret           /
```

--------------------------------

### Initial unprotected application with is_registered()

Source: https://vmpsoft.com/vmprotect/user-manual

Simple console app that checks a serial number by comparing its first character to 'X'. Used as the starting point before adding VMProtect licensing.

```c
#include <windows.h>
#include <stdio.h>
bool is_registered(const char *serial)
{
        return serial && serial[0] == 'X';
}
int main(int argc, char **argv)
{
        char *serial = "Xserialnumber"; // we set the serial number directly in the code, for simplicity
        if (!is_registered(serial))
        {
                printf("please register!\n");
                return 0;
        }
        printf("We are registered.\n");
        return 0;
}
```

--------------------------------

### Generator setup code with exported algorithm parameters

Source: https://vmpsoft.com/vmprotect/user-manual

This block is automatically generated by VMProtect and must be copied accurately. It contains the algorithm type, bit length, private key, modulus, and product code. Incorrect copying will cause the generator to work incorrectly.

```php
//////////////////////////////////////////////////////////////////////////////////////////////
// The following lines should be generated by VMProtect License Manager
$exported_algorithm = "RSA";
$exported_bits = 2048;
$exported_private = "PJvj4kEpoQMIpYK+9wEt......xKeiSZgzdiln8Q==";
$exported_modulus = "rOlny/3QgZb/VmGr3CmY......I6ESAUmtQ+RBqQ==";
$exported_product_code = "oLQdGUn8kVk=";
//////////////////////////////////////////////////////////////////////////////////////////////
```

--------------------------------

### MacCommands class for working with Mach-O load command lists

Source: https://vmpsoft.com/vmprotect/user-manual

Provides methods to access load commands by index or type and get the count of commands.

```c
class MacCommands {
public:
	MacCommand item(int index); // returns a command with the given index
	int count(); // returns the number of command in the list
	MacCommand itemByType(int type); // returns a command of the given type
};
```

--------------------------------

### Get current hardware ID (main function)

Source: https://vmpsoft.com/vmprotect/user-manual

Minimized main() function that retrieves the current hardware ID using VMProtectGetCurrentHWID and prints it.

```c
int main(int argc, char **argv)
{
        int nSize = VMProtectGetCurrentHWID(NULL, 0);
        char *buf = new char[nSize];
        VMProtectGetCurrentHWID(buf, nSize);
        printf("HWID: %s\n", buf);
        delete [] buf;
        return 0;
}
```

--------------------------------

### Correct usage of VMProtectGetCurrentHWID

Source: https://vmpsoft.com/vmprotect/user-manual

Shows the recommended pattern: first call with NULL to get the required buffer size, allocate memory, then call again to obtain the identifier, and finally release the memory.

```c
int nSize = VMProtectGetCurrentHWID(NULL, 0); // get the required buffer size
char *pBuf = new char[nSize]; // allocate memory for the buffer
VMProtectGetCurrentHWID(pBuf, nSize); // obtain the identifier
// use the identifier
delete [] pBuf; // release memory
```

--------------------------------

### Date storage format example

Source: https://vmpsoft.com/vmprotect/user-manual

Shows how to read or write a date in the serial number's Little Endian format. The date is stored as a DWORD with the year in the high word and month/day in the low word.

```none
byte *pDate = 0xNNNNNN; // date address
*(DWORD *)pDate = (2010 << 16) | (10 << 8) | 1; // October 1, 2010
DWORD dwExp = *(DWORD *)pDate;
```

--------------------------------

### Generate serial number with VMProtect KeyGen .NET

Source: https://vmpsoft.com/vmprotect/user-manual

Example code to call the generator. It creates a Generator instance with exported data, sets user properties, and calls Generate() to produce a serial number. The constructor throws an exception if parsing the product data fails, and Generate() throws if data exceeds allowed length.

```csharp
try
{
        string data = @""; // put the exported data here
        Generator g = new Generator(data);
        g.UserName = "John Doe";
        g.EMail = "john@doe.com";
        g.ExpirationDate = DateTime.Now.AddMonths(1);
        g.MaxBuildDate = DateTime.Now.AddYears(1);
        g.RunningTimeLimit = 15;
        g.HardwareID = "AQIDBAgHBgU=";
        g.UserData = new byte[] { 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 };
        string serial = g.Generate();
        Console.WriteLine("Serial number:\n{0}\n", serial);
}
catch (Exception ex)
{
        Console.WriteLine("Error: {0}", ex);
}    
```

--------------------------------

### Hardware-locked serial number check (main function)

Source: https://vmpsoft.com/vmprotect/user-manual

main() function that gets the current hardware ID, prints it, then sets a serial number and prints the state. Used to test hardware locking.

```c
int main(int argc, char **argv)
{
        int nSize = VMProtectGetCurrentHWID(NULL, 0);
        char *buf = new char[nSize];
        VMProtectGetCurrentHWID(buf, nSize);
        printf("HWID: %s\n", buf);
        delete [] buf;
        char *serial = "Xserialnumber";
        int res = VMProtectSetSerialNumber(serial);
        print_state(res);
        return 0;
}
```

--------------------------------

### Generate serial number with VMProtectGenerateSerialNumber

Source: https://vmpsoft.com/vmprotect/user-manual

Complete example that fills VMProtectProductInfo and VMProtectSerialNumberInfo, calls VMProtectGenerateSerialNumber, prints the serial number, and frees memory. The initial block of exported data must be replaced with the one generated by VMProtect for your product. User name and email are accepted in UNICODE and converted to UTF-8.

```c
//////////////////////////////////////////////////////////////////////////
// !!! this block should be generated by VMProtect !!!                 ///
//////////////////////////////////////////////////////////////////////////
VMProtectAlgorithms g_Algorithm = ALGORITHM_RSA;
size_t g_nBits = 0;
byte g_vModulus[1];
byte g_vPrivate[1];
byte g_vProductCode[1];
//////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////
int _tmain(int argc, _TCHAR* argv[])
{
        VMProtectProductInfo     pi;
        pi.algorithm = g_Algorithm;
        pi.nBits = g_nBits;
        pi.nModulusSize = sizeof(g_vModulus);
        pi.pModulus = g_vModulus;
        pi.nPrivateSize = sizeof(g_vPrivate);
        pi.pPrivate = g_vPrivate;
        pi.nProductCodeSize = sizeof(g_vProductCode);
        pi.pProductCode = g_vProductCode;
        VMProtectSerialNumberInfo si = {0};
        si.flags = HAS_USER_NAME | HAS_EMAIL;
        si.pUserName = L"John Doe";
        si.pEMail = L"john@doe.com";
        char * pBuf = NULL;
        VMProtectErrors res = VMProtectGenerateSerialNumber(&pi, &si, &pBuf);
        if (res == ALL_RIGHT)
        {
                printf("Serial number:\n%s\n", pBuf);
                VMProtectFreeSerialNumberMemory(pBuf);
        }
        else
        {
                printf("Error: %d\n", res);
        }
        return 0;
} 
```

--------------------------------

### PEReloc Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a PE architecture fixup (relocation). Provides a method to get the address of the element.

```APIDOC
## PEReloc Class

### Description
Represents a PE architecture fixup (relocation). Provides a method to get the address of the element.

### Methods
- **address()** (uint64) - Returns the address of the element.
```

--------------------------------

### Check serial number and print max build date

Source: https://vmpsoft.com/vmprotect/user-manual

Modify the main() function to set a serial number, check its state, and print the maximum build date. If the serial is valid, it prints the max build date and asks for registration; otherwise it prints 'I'm registered'.

```c
int main(int argc, char **argv)
{
        char *serial = "Xserialnumber"; // we set the serial number directly in the code, for simplicity
        int res = VMProtectSetSerialNumber(serial);
        print_state(res);
        if (res)
        {
                VMProtectSerialNumberData sd = {0};
                VMProtectGetSerialNumberData(&sd, sizeof(sd));
                printf("max. build date: y = %d, m = %d, d = %d\n", sd.dtMaxBuild.wYear, sd.dtMaxBuild.bMonth, sd.dtMaxBuild.bDay);
                printf("please register!\n");
                return 0;
        }
        printf("I'm registered\n");
        return 0;
}
```

--------------------------------

### Include VMProtectSDK.h header

Source: https://vmpsoft.com/vmprotect/user-manual

Adds the VMProtect SDK header to the main file. Requires VMProtectSDK.h, VMProtectSDK32.lib, and VMProtectSDK32.dll (or 64-bit equivalents) in the working folder.

```c
#include <windows.h>
#include <stdio.h>
#include "VMProtectSDK.h"
```

--------------------------------

### PEDirectory Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a PE directory and provides methods to get and set its address, name, size, and type.

```APIDOC
## PEDirectory Class

### Description
Represents a PE directory and provides methods to get and set its address, name, size, and type.

### Methods
- **address()** (uint64) - Returns the address of the directory.
- **name()** (string) - Returns the name of the directory.
- **size()** (uint64) - Returns the size of the directory.
- **type()** (int) - Returns the type of the directory.
- **setAddress(uint64 address)** (void) - Sets the address of the directory.
- **setSize(int size)** (void) - Sets the size of the directory.
- **clear()** (void) - Clears the address and the size of the directory.
```

--------------------------------

### FFILibrary class

Source: https://vmpsoft.com/vmprotect/user-manual

Class to work with a library. Provides methods to get the library name, address, close the library, and retrieve functions.

```APIDOC
## FFILibrary class

### Description
Class to work with a library. Provides methods to get the library name, address, close the library, and retrieve functions.

### Methods
- `string name()` - Returns the name.
- `uint64 address()` - Returns the address in the memory.
- `void close()` - Closes the library.
- `FFIFunction getFunction(string name, ParamType ret, ParamType param1, ...)` - Returns a function.
- `FFIFunction getFunction(string name, table (ParamType ret, CallType abi, ParamType, ...))` - Returns a function.

```

--------------------------------

### Files class

Source: https://vmpsoft.com/vmprotect/user-manual

Provides access to the list of files in the project.

```c
class Files {
public:
	File item(int index); // returns a file with the given index
	int count(); // returns the number of files in the list
}
```

--------------------------------

### File class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a single file with name, filename, and options.

```c
class File {
public:
	string name(); // returns the name of the file
	string fileName(); // returns the filename
	int options(); // returns options
	void setName(string name); // sets the name of the file
	void setFileName(string name); // sets the filename of the file
	void setOptions(); // sets options
}
```

--------------------------------

### MacSections class for working with Mach-O section lists

Source: https://vmpsoft.com/vmprotect/user-manual

Provides methods to access sections by index or address and get the count of sections.

```c
class MacSections {
public:
	MacSection item(int index); // returns a section with the given index
	int count(); // returns the number of sections in the list
	MacSection itemByAddress(uint64 address); // returns a section at the given address
};
```

--------------------------------

### MacSegments class for working with Mach-O segment lists

Source: https://vmpsoft.com/vmprotect/user-manual

Provides methods to access segments by index or address and get the count of segments.

```c
class MacSegments {
public:
	MacSegment item(int index); // returns a segment with the given index
	int count(); // returns the number of segments in the list
	MacSegment itemByAddress(); // returns a segment at the given address
};
```

--------------------------------

### PEReloc class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEReloc class for working with a PE fixup (relocation). Provides a method to get the address of the element.

```c
class PEReloc {
public:
	uint64 address(); // returns the address of the element
};
```

--------------------------------

### Run old version with blocked serial number for comparison

Source: https://vmpsoft.com/vmprotect/user-manual

Command-line output when running the old version (dummy_app1.vmp.exe) with the same blocked serial number. The old version does not know about the block and still accepts the serial number.

```c
C:\test>dummy_app1.vmp.exe
serial number is correct, calling foo()
I'm foo
done
```

--------------------------------

### Expected output: res = 0x00000002

Source: https://vmpsoft.com/vmprotect/user-manual

Shows the output when the licensing system rejects the serial number because no valid key is configured yet.

```c
res = 0x00000002
```

--------------------------------

### PERelocs Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a list of PE architecture fixups (relocations). Provides methods to access items by index or address and get the count.

```APIDOC
## PERelocs Class

### Description
Represents a list of PE architecture fixups (relocations). Provides methods to access items by index or address and get the count.

### Methods
- **item(int index)** (PEReloc) - Returns an element with the given index.
- **count()** (int) - Returns the number of elements in the list.
- **itemByAddress(uint64 address)** (PEReloc) - Returns an element at the given address.
```

--------------------------------

### PEImports Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a list of imported libraries for the PE architecture. Provides methods to access items by index or name and get the count.

```APIDOC
## PEImports Class

### Description
Represents a list of imported libraries for the PE architecture. Provides methods to access items by index or name and get the count.

### Methods
- **item(int index)** (PEImport) - Returns a library with the given index.
- **count()** (int) - Returns the number of libraries in the list.
- **itemByName(string name)** (PEImport) - Returns a library with the given name.
```

--------------------------------

### Core class

Source: https://vmpsoft.com/vmprotect/user-manual

Provides methods to manage the VMProtect project, including file names, options, VM section name, licenses, files, and watermarks.

```c
class Core {
public:
	string projectFileName(); // returns the name of the project
	void saveProject(); // saves the project
	string inputFileName(); // returns the name of the source file for the current project
	string outputFileName(); // returns the name of the output file for the current project
	void setOutputFileName(string name); // sets the name of the output file for the current project
	string watermarkName(); // returns the name of the watermark of the current project
	void setWatermarkName(string name); // sets the name of the watermark for the current project
	int options(); // returns options of the current project                                                            
	void setOptions(int options); // sets options of the current project
	string vmSectionName(); // returns VM segment name for the current project
	void setVMSectionName(); // sets VM segment name for the current project
	Licenses licenses(); // returns the list of licenses for the current project
	Files files(); // returns the list of files for the current project
	Watermarks watermarks(); // returns the list of watermarks
	PEFile/MacFile inputFile(); // returns source file
	PEFile/MacFile outputFile(); // returns output file
	PEArchitecture/MacArchitecture inputArchitecture(); // returns source architecture
	PEArchitecture/MacArchitecture outputArchitecture(); // returns output architecture
};
```

--------------------------------

### PEExport Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a PE architecture exported function. Provides methods to get the address, name, ordinal, forwarded name, and destroy the function.

```APIDOC
## PEExport Class

### Description
Represents a PE architecture exported function. Provides methods to get the address, name, ordinal, forwarded name, and destroy the function.

### Methods
- **address()** (uint64) - Returns the address of the exported function.
- **name()** (string) - Returns the name of the exported function.
- **ordinal()** (int) - Returns the ordinal of the exported function.
- **forwardedName()** (string) - Returns the name of the function the exported function forwards to.
- **destroy()** (void) - Destroys the exported function.
```

--------------------------------

### Secure Key Check Using PJW Hash (Delphi/Pascal)

Source: https://vmpsoft.com/vmprotect/user-manual

Recommended approach: compare hashes of keys instead of actual values. Uses Peter Weinberger's PJW hashing algorithm. HashPJW and CheckRegistration should be processed with VMProtect.

```pascal
var
  HashOfValidRegNumber: Longint;
...
// Peter Weinberger's PJW hashing algorithm example of use
function HashPJW(const Value: String): Longint;
var I:Integer;
    G:Longint;
begin
  Result:=0;
  for I:=1 to Length(Value) do
   begin
    Result:=(Result shl 4)+Ord(Value[I]);
    G:=Result and $F0000000;
    if G<&gt0 then
     Result:=(Result xor (G shr 24)) xor G;
   end;
end;
function CheckRegistration(const RegNumber: String): Boolean;
begin
  if HashPJW(RegNumber)=HashOfValidRegNumber then
   Result:=True
  else
   Result:=False;
end;
...
initialization
  HashOfValidRegNumber:=HashPJW(ValidRegNumber);
end.
```

--------------------------------

### Core Class

Source: https://vmpsoft.com/vmprotect/user-manual

Provides access to project-level settings and operations such as saving the project, managing input/output files, watermarks, and options.

```APIDOC
## Core Class

### Description
Provides access to project-level settings and operations such as saving the project, managing input/output files, watermarks, and options.

### Methods
- **projectFileName()** - Returns the name of the project.
- **saveProject()** - Saves the project.
- **inputFileName()** - Returns the name of the source file for the current project.
- **outputFileName()** - Returns the name of the output file for the current project.
- **setOutputFileName(string name)** - Sets the name of the output file for the current project.
- **watermarkName()** - Returns the name of the watermark of the current project.
- **setWatermarkName(string name)** - Sets the name of the watermark for the current project.
- **options()** - Returns options of the current project.
- **setOptions(int options)** - Sets options of the current project.
- **vmSectionName()** - Returns VM segment name for the current project.
- **setVMSectionName()** - Sets VM segment name for the current project.
- **licenses()** - Returns the list of licenses for the current project.
- **files()** - Returns the list of files for the current project.
- **watermarks()** - Returns the list of watermarks.
- **inputFile()** - Returns source file.
- **outputFile()** - Returns output file.
- **inputArchitecture()** - Returns source architecture.
- **outputArchitecture()** - Returns output architecture.

### Project Options
- **None** - No options.
- **Pack** - Pack the output file.
- **ImportProtection** - Protect imports.
- **MemoryProtection** - Protect memory.
- **ResourceProtection** - Protect resources.
- **CheckDebugger** - Check for debugger.
- **CheckKernelDebugger** - Check for kernel debugger.
- **CheckVirtualMachine** - Check for virtual machine.
- **StripFixups** - Strip fixups.
- **StripDebugInfo** - Strip debug info.
- **DebugMode** - Enable debug mode.
```

--------------------------------

### PEImport Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents an imported library for the PE architecture. Provides methods to get the library name, access imported functions, and set the name.

```APIDOC
## PEImport Class

### Description
Represents an imported library for the PE architecture. Provides methods to get the library name, access imported functions, and set the name.

### Methods
- **name()** (string) - Returns the name of the library.
- **item(int index)** (PEImportFunction) - Returns an imported function with the given index.
- **count()** (int) - Returns the number of imported functions.
- **setName(string name)** (void) - Sets the name of the library.
```

--------------------------------

### Licenses class

Source: https://vmpsoft.com/vmprotect/user-manual

Provides access to the list of licenses and key parameters.

```c
class Licenses {
public:
	int keyLength(); // returns the length of the key
	string publicExp(); // returns the public exponent
	string privateExp(); // returns the private exponent
	string modulus(); // returns modulus
	License item(int index); // returns a license with the given index
	int count(); // returns the number of licenses in the list
}
```

--------------------------------

### PEResources Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a list of PE architecture resources. Provides methods to access items by index, type, or name, get the count, and clear the list.

```APIDOC
## PEResources Class

### Description
Represents a list of PE architecture resources. Provides methods to access items by index, type, or name, get the count, and clear the list.

### Methods
- **item(int index)** (PEResource) - Returns a resource with the given index.
- **count()** (int) - Returns the number of resources in the list.
- **clear()** (void) - Clears the list.
- **itemByType(int type)** (PEResource) - Returns a resource of the given type.
- **itemByName(string name)** (PEResource) - Returns a resource with the given name.
```

--------------------------------

### Output when MaxBuildDate is today or tomorrow

Source: https://vmpsoft.com/vmprotect/user-manual

Expected output when the MaxBuildDate is set to today or tomorrow. The program is considered registered.

```c
state = 0
I'm registered
```

--------------------------------

### PEImportFunction Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a PE architecture imported function. Provides methods to get the memory address where the imported function address is stored and the function name.

```APIDOC
## PEImportFunction Class

### Description
Represents a PE architecture imported function. Provides methods to get the memory address where the imported function address is stored and the function name.

### Methods
- **address()** (uint64) - Returns a memory address where the imported function address is stored.
- **name()** (string) - Returns the name of the imported function.
```

--------------------------------

### PEDirectory class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEDirectory class for working with a PE directory. Provides methods to get and set the directory's address and size, and to clear them.

```c
class PEDirectory {
public:
	uint64 address(); // returns the address of the directory
	string name(); // returns the name of the directory
	uint64 size(); // returns the size of the directory
	int type(); // returns the type of the directory
	void setAddress(uint64 address); // sets the address of the directory
	void setSize(int size); // sets the size of the directory
	void clear(); // clears the address and the size of the directory
};
```

--------------------------------

### VMProtectLicense.ini test license configuration

Source: https://vmpsoft.com/vmprotect/user-manual

Creates a test license in VMProtectLicense.ini. The AcceptedSerialNumber value must match the serial passed to VMProtectSetSerialNumber for the license to be accepted.

```php
[TestLicense]
AcceptedSerialNumber=Xserialnumber 
```

--------------------------------

### PEExports Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a list of exported functions for the PE architecture. Provides methods to access items by index, address, or name, get the count, and clear the list.

```APIDOC
## PEExports Class

### Description
Represents a list of exported functions for the PE architecture. Provides methods to access items by index, address, or name, get the count, and clear the list.

### Methods
- **name()** (string) - Returns the name of the library.
- **item(int index)** (PEExport) - Returns an exported function with the given index.
- **count()** (int) - Returns the number of exported functions in the list.
- **clear()** (void) - Clears the list.
- **itemByAddress(uint64 address)** (PEExport) - Returns an exported function at the given address.
- **itemByName(string name)** (PEExport) - Returns an exported function with the given name.
```

--------------------------------

### OnBeforePackFile event handler skeleton

Source: https://vmpsoft.com/vmprotect/user-manual

Empty handler for the OnBeforePackFile event, invoked before packing the protected file. Only invoked when the 'Pack output file' option is enabled. Use this handler to modify the file to be packed.

```c
function OnBeforePackFile()
end
```

--------------------------------

### PERelocs class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PERelocs class for working with a list of PE fixups (relocations). Provides methods to access elements by index or address and to get the count.

```c
class PERelocs {
public:
	PEReloc item(int index); // returns an element with the given index
	int count(); // returns the number of elements in the list
	PEReloc itemByAddress(uint64 address); // returns an element at the given address
};
```

--------------------------------

### Output with custom hardware ID

Source: https://vmpsoft.com/vmprotect/user-manual

Expected output after setting MyHWID=test: HWID: test.

```text
HWID: test
```

--------------------------------

### PEImports class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEImports class for working with a list of imported libraries in a PE file. Provides methods to access libraries by index or name and to get the count.

```c
class PEImports {
public:
	PEImport item(int index); // returns a library with the given index
	int count(); // returns the number of libraries in the list
	PEImport itemByName(string name); // returns a library with the given name
};
```

--------------------------------

### VMProtect_Con.exe Command-Line Usage

Source: https://vmpsoft.com/vmprotect/user-manual

Command-line syntax for the console version of VMProtect. Parameters include File, Output File, Project File, Script File, Licensing Parameters File, Build Date, Watermark Name, and the -we flag to treat warnings as errors. The console version is not available for the Lite edition.

```c
VMProtect_Con File [Output File] [-pf Project File] [-sf Script File] [-lf Licensing Parameters File] [-bd Build Date (yyyy-mm-dd)] [-wm Watermark Name] [-we]
```

--------------------------------

### Folder class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a custom folder with subfolders and methods to manage them.

```c
class Folder {
public:
	int count(); // returns the number of subfolders
	Folder item(int index); // returns a subfolder with the given index
	Folder add(string name); // adds a new subfolder
	string name(); // returns the name of the folder
	void clear(); // clears the list of subfolders
	void destroy(); // destroys the folder an all child subfolders
};
```

--------------------------------

### PEExport class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEExport class for working with an exported function in a PE file. Provides methods to get the address, name, ordinal, forwarded name, and to destroy the function.

```c
class PEExport {
public:
	uint64 address(); // returns the address of the exported function
	string name(); // returns the name of the exported function
	int ordinal();  // returns the ordinal of the exported function
	string forwardedName(); // returns the name of the function the exported function forwards to
	void destroy(); // destroys the exported function
};
```

--------------------------------

### PEImportFunction class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEImportFunction class for working with an imported function in a PE file. Provides methods to get the address where the imported function address is stored and the function name.

```c
class PEImportFunction {
public:
	uint64 address(); // returns a memory address where the imported function address is stored
	string name();  // returns the name of the imported function
};
```

--------------------------------

### VMProtectBeginVirtualization

Source: https://vmpsoft.com/vmprotect/user-manual

Marks the beginning of a protected code area with the predefined "virtualization" compilation type.

```APIDOC
## VMProtectBeginVirtualization

### Description
Marks the beginning of a protected code area with the predefined "virtualization" compilation type. The compilation type cannot be changed later.

### Function Signature
void VMProtectBeginVirtualization(const char *MarkerName);

### Parameters
- **MarkerName** (const char*) - Required - The name of the marker. If not set, a unique name is generated.
```

--------------------------------

### PEImport class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEImport class for working with an imported library in a PE file. Provides methods to get the library name, access imported functions, and set the name.

```c
class PEImport {
public:
	string name(); // returns the name of the library
	PEImportFunction item(int index); // returns an imported function with the given index
	int count(); // returns the number of imported functions
	void setName(string name); // sets the name of the library
};
```

--------------------------------

### Multiple Obfuscation attributes on a class

Source: https://vmpsoft.com/vmprotect/user-manual

Shows how to apply multiple Obfuscation attributes to a class and its method, combining string obfuscation, renaming exclusion, and virtualization.

```csharp
[Obfuscation(Feature = "strings", Exclude = false)]
class Class
{
	[Obfuscation(Feature = "renaming", Exclude = true)]
	[Obfuscation(Feature = "virtualization", Exclude = false)]
	public Foo()
	{
...
```

--------------------------------

### Set MaxBuildDate in ini-file

Source: https://vmpsoft.com/vmprotect/user-manual

Add this line to the ini-file to limit the free upgrades period. The date must be in the past for test mode to work correctly.

```c
MaxBuildDate=20000101
```

--------------------------------

### OnBeforePackFile event

Source: https://vmpsoft.com/vmprotect/user-manual

Event handler invoked before packing the protected file. Allows modifying the file to be packed. Only invoked if the 'Pack output file' option is enabled.

```APIDOC
## OnBeforePackFile event

### Description
The event is invoked before packing the protected file of the application. With OnBeforePackFile you can modify a file that is to be packed. This event is only invoked if the 'Pack output file' option is enabled.

### Event Handler Signature
```lua
function OnBeforePackFile()
end
```
```

--------------------------------

### Run new version with blocked serial number

Source: https://vmpsoft.com/vmprotect/user-manual

Command-line output when running the newly protected version (dummy_app.vmp.exe) with a serial number that has been marked as blocked. The licensing module returns the SERIAL_STATE_FLAG_BLACKLISTED flag.

```c
C:\test>dummy_app.vmp.exe
serial number is bad
state = SERIAL_STATE_FLAG_BLACKLISTED
```

--------------------------------

### PEResource Class

Source: https://vmpsoft.com/vmprotect/user-manual

Represents a PE architecture resource. Provides methods to access child resources, get address, size, name, type, directory property, and excluded from packing property, and destroy the resource.

```APIDOC
## PEResource Class

### Description
Represents a PE architecture resource. Provides methods to access child resources, get address, size, name, type, directory property, and excluded from packing property, and destroy the resource.

### Methods
- **item(int index)** (PEResource) - Returns a resource with the given index.
- **count()** (int) - Returns the number of resources in the list.
- **clear()** (void) - Clears the list.
- **address()** (uint64) - Returns the address of the resource.
- **size()** (int) - Returns the size of the resource.
- **name()** (string) - Returns the name of the resource.
- **type()** (int) - Returns the type of the resource.
- **isDirectory()** (bool) - Returns the "Directory" property.
- **destroy()** (void) - Destroys the resource.
- **itemByName(string name)** (PEResource) - Returns a resource with the given name.
- **excludedFromPacking()** (bool) - Returns the "Excluded from packing" property.
```

--------------------------------

### PEExports class definition

Source: https://vmpsoft.com/vmprotect/user-manual

Defines the PEExports class for working with a list of exported functions in a PE file. Provides methods to get the library name, access exported functions by index, address, or name, and clear the list.

```c
class PEExports {
public:
	string name(); // returns the name of the library
	PEExport item(int index); // returns an exported function with the given index
	int count(); // returns the number of exported functions in the list
	void clear(); // clears the list
	PEExport itemByAddress(uint64 address); // returns an exported function at the given address
	PEExport itemByName(string name); // returns an exported function with the given name
};
```
Tokens:
Raw