313 lines
12 KiB
HTML
313 lines
12 KiB
HTML
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|||
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|||
|
|
|
|||
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|||
|
|
<head>
|
|||
|
|
<link rel="Stylesheet" type="text/css" href=
|
|||
|
|
"../../default.css" />
|
|||
|
|
<meta http-equiv="Content-Type" content=
|
|||
|
|
"text/html; charset=utf-8" />
|
|||
|
|
|
|||
|
|
<title>Описание функций API лицензирования</title>
|
|||
|
|
<style type="text/css">
|
|||
|
|
/*<![CDATA[*/
|
|||
|
|
th {text-align:left;}
|
|||
|
|
table {border-collapse:collapse; margin-top: 4px;}
|
|||
|
|
td,th {border: 1px solid #B0B0B0; padding-left:10;padding-right:10;}
|
|||
|
|
/*]]>*/
|
|||
|
|
</style>
|
|||
|
|
</head>
|
|||
|
|
|
|||
|
|
<body>
|
|||
|
|
<h1>Описание функций API лицензирования</h1>
|
|||
|
|
|
|||
|
|
<p>API системы лицензирования является продолжением API VMProtect
|
|||
|
|
и входит в его SDK. API позволяет задать серийный номер и
|
|||
|
|
получить информацию о нем: подходит он к программе или нет, истек
|
|||
|
|
ли срок действия, на кого зарегистрирован продукт и т.п. Также API
|
|||
|
|
позволяет получить идентификатор оборудования, на котором
|
|||
|
|
выполняется программа.</p><strong id=
|
|||
|
|
"VMProtectSetSerialNumber">VMProtectSetSerialNumber</strong>
|
|||
|
|
|
|||
|
|
<p>Функция предназначена для загрузки серийного номера в систему
|
|||
|
|
лицензирования. Полный формат вызова представлен ниже:</p>
|
|||
|
|
<pre class="code">int VMProtectSetSerialNumber(const char *SerialNumber);
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Входной параметр <strong>SerialNumber</strong> должен
|
|||
|
|
содержать указатель на текстовую строку с серийным номером в
|
|||
|
|
кодировке base-64 и завершаемую нулем ('\0'). Функция возвращает
|
|||
|
|
битовую маску флагов состояния серийного номера, аналогичную той,
|
|||
|
|
что возвращает <strong>VMProtectGetSerialNumberState()</strong>,
|
|||
|
|
подробнее о флагах будет написано ниже. Серийный номер считается
|
|||
|
|
"хорошим", если функция вернула значение 0.</p><br />
|
|||
|
|
<strong id=
|
|||
|
|
"VMProtectGetSerialNumberState">VMProtectGetSerialNumberState</strong>
|
|||
|
|
|
|||
|
|
<p>Функция возвращает флаги состояния серийного номера,
|
|||
|
|
предварительно установленного вызовом
|
|||
|
|
<strong>VMProtectSetSerialNumber()</strong>.</p>
|
|||
|
|
<pre class="code">int VMProtectGetSerialNumberState();
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Наличие хотя бы одного установленного флага говорит о
|
|||
|
|
проблемах с серийным номером: программа не должна работать, если
|
|||
|
|
установлен хотя бы один бит. Подробные значениях флагов описаны в
|
|||
|
|
таблице:</p>
|
|||
|
|
|
|||
|
|
<table border="1" cellspacing="0" cellpadding="2">
|
|||
|
|
<tr>
|
|||
|
|
<th>Флаг</th>
|
|||
|
|
|
|||
|
|
<th>Значение</th>
|
|||
|
|
|
|||
|
|
<th>Описание</th>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_CORRUPTED</td>
|
|||
|
|
|
|||
|
|
<td>0x00000001</td>
|
|||
|
|
|
|||
|
|
<td>Система лицензирования повреждена. Возможные причины:
|
|||
|
|
некорректная настройка проекта защиты, попытка взлома
|
|||
|
|
программы.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_INVALID</td>
|
|||
|
|
|
|||
|
|
<td>0x00000002</td>
|
|||
|
|
|
|||
|
|
<td>Серийный номер некорректен. Флаг выставляется, если
|
|||
|
|
система лицензирования не может расшифровать серийный
|
|||
|
|
номер.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_BLACKLISTED</td>
|
|||
|
|
|
|||
|
|
<td>0x00000004</td>
|
|||
|
|
|
|||
|
|
<td>Серийный номер подходит к продукту, однако занесен в
|
|||
|
|
черный список в VMProtect.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_DATE_EXPIRED</td>
|
|||
|
|
|
|||
|
|
<td>0x00000008</td>
|
|||
|
|
|
|||
|
|
<td>Срок действия серийного номера истек. Подробную
|
|||
|
|
информацию о сроке действия можно получить вызовом
|
|||
|
|
<strong>VMProtectGetSerialNumberData()</strong></td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_RUNNING_TIME_OVER</td>
|
|||
|
|
|
|||
|
|
<td>0x00000010</td>
|
|||
|
|
|
|||
|
|
<td>Время работы программы истекло. Подробную информацию о
|
|||
|
|
времени работы программы можно получить вызовом
|
|||
|
|
<strong>VMProtectGetSerialNumberData()</strong></td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_BAD_HWID</td>
|
|||
|
|
|
|||
|
|
<td>0x00000020</td>
|
|||
|
|
|
|||
|
|
<td>Идентификатор оборудования не совпадает с тем, что
|
|||
|
|
записан в серийном номере.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>SERIAL_STATE_FLAG_MAX_BUILD_EXPIRED</td>
|
|||
|
|
|
|||
|
|
<td>0x00000040</td>
|
|||
|
|
|
|||
|
|
<td>Серийный номер не предназначен для работы с этой версией
|
|||
|
|
защищаемой программы. Максимальную дату сборки программы, к
|
|||
|
|
которой подходит этот серийный номер, можно узнать вызовом
|
|||
|
|
<strong>VMProtectGetSerialNumberData()</strong>.</td>
|
|||
|
|
</tr>
|
|||
|
|
</table><br /><br />
|
|||
|
|
<strong id=
|
|||
|
|
"VMProtectGetSerialNumberData">VMProtectGetSerialNumberData</strong>
|
|||
|
|
|
|||
|
|
<p>Функция предназначена для получения информации о содержимом
|
|||
|
|
серийного номера, установленного вызовом
|
|||
|
|
<strong>VMProtectSetSerialNumber()</strong>. Формат вызова
|
|||
|
|
представлен ниже:</p>
|
|||
|
|
<pre class="code">bool VMProtectGetSerialNumberData(VMProtectSerialNumberData *Data, int Size);
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Первый параметр - указатель на структуру
|
|||
|
|
<strong>VMProtectSerialNumberData</strong>, в которую будет
|
|||
|
|
записана вся необходимая информация. Второй параметр - размер
|
|||
|
|
структуры, передаваемой в первом параметре - служит для контроля
|
|||
|
|
формата структуры. Функция возвращает FALSE в случаях, если система
|
|||
|
|
лицензирования повреждена (см. флаг состояния
|
|||
|
|
SERIAL_STATE_FLAG_CORRUPTED), если на вход подан нулевой адрес
|
|||
|
|
структуры или если переданный размер структуры некорректен. Во
|
|||
|
|
всех остальных случаях функция возвращает TRUE и записывает всю
|
|||
|
|
информацию о серийном номере по указанном адресу. Ниже
|
|||
|
|
описываются все элементы структуры:</p>
|
|||
|
|
|
|||
|
|
<table border="1" cellspacing="0" cellpadding="2">
|
|||
|
|
<tr>
|
|||
|
|
<th>Элемент</th>
|
|||
|
|
|
|||
|
|
<th>Тип</th>
|
|||
|
|
|
|||
|
|
<th>Описание</th>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>nState</td>
|
|||
|
|
|
|||
|
|
<td>int</td>
|
|||
|
|
|
|||
|
|
<td>Битовая маска флагов проверки ключа. Аналогична той, что
|
|||
|
|
возвращает
|
|||
|
|
<strong>VMProtectGetSerialNumberState()</strong>.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>wUserName</td>
|
|||
|
|
|
|||
|
|
<td>wchar_t[256]</td>
|
|||
|
|
|
|||
|
|
<td>Имя покупателя в кодировке UNICODE, завершаемое
|
|||
|
|
нулем.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>wEMail</td>
|
|||
|
|
|
|||
|
|
<td>wchar_t[256]</td>
|
|||
|
|
|
|||
|
|
<td>E-Mail покупателя в кодировке UNICODE, завершаемый
|
|||
|
|
нулем.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>dtExpire</td>
|
|||
|
|
|
|||
|
|
<td>VMProtectDate</td>
|
|||
|
|
|
|||
|
|
<td>Дата окончания срока действия ключа. Формат структуры
|
|||
|
|
VMProtectDate описан ниже.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>dtMaxBuild</td>
|
|||
|
|
|
|||
|
|
<td>VMProtectDate</td>
|
|||
|
|
|
|||
|
|
<td>Максимальная дата сборки продукта, с которой будет
|
|||
|
|
работать этот ключ. Формат структуры VMProtectDate описан
|
|||
|
|
ниже.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>bRunningTime</td>
|
|||
|
|
|
|||
|
|
<td>int</td>
|
|||
|
|
|
|||
|
|
<td>Количество минут, которое программа будет работать
|
|||
|
|
(максимальная длина сессии). Измеряется в минутах,
|
|||
|
|
отсчитывается с момента запуска программы.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>nUserDataLength</td>
|
|||
|
|
|
|||
|
|
<td>unsigned char</td>
|
|||
|
|
|
|||
|
|
<td>Длина пользовательских данных, размещенных в поле
|
|||
|
|
<strong>bUserData</strong>.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>bUserData</td>
|
|||
|
|
|
|||
|
|
<td>unsigned char[255]</td>
|
|||
|
|
|
|||
|
|
<td>Пользовательские данные, записанные в ключ. Количество
|
|||
|
|
актуальных байт указано в поле
|
|||
|
|
<strong>nUserDataLength</strong>.</td>
|
|||
|
|
</tr>
|
|||
|
|
</table><br />
|
|||
|
|
|
|||
|
|
<p>Структура <strong>VMProtectDate</strong> предназначена для
|
|||
|
|
компактного хранения даты. Ее поля описаны в таблице:</p>
|
|||
|
|
|
|||
|
|
<table border="1" cellspacing="0" cellpadding="2">
|
|||
|
|
<tr>
|
|||
|
|
<th>Элемент</th>
|
|||
|
|
|
|||
|
|
<th>Тип</th>
|
|||
|
|
|
|||
|
|
<th>Описание</th>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>wYear</td>
|
|||
|
|
|
|||
|
|
<td>unsigned short</td>
|
|||
|
|
|
|||
|
|
<td>Год.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>bMonth</td>
|
|||
|
|
|
|||
|
|
<td>unsigned char</td>
|
|||
|
|
|
|||
|
|
<td>Месяц, нумерация начинается с единицы.</td>
|
|||
|
|
</tr>
|
|||
|
|
|
|||
|
|
<tr>
|
|||
|
|
<td>bDay</td>
|
|||
|
|
|
|||
|
|
<td>unsigned char</td>
|
|||
|
|
|
|||
|
|
<td>День, нумерация начинается с единицы.</td>
|
|||
|
|
</tr>
|
|||
|
|
</table><br />
|
|||
|
|
<br />
|
|||
|
|
<strong id=
|
|||
|
|
"VMProtectGetCurrentHWID">VMProtectGetCurrentHWID</strong>
|
|||
|
|
|
|||
|
|
<p>Функция предназначена для получения идентификатора
|
|||
|
|
оборудования, на котором работает программа. Формат вызова
|
|||
|
|
следующий:</p>
|
|||
|
|
<pre class="code">int VMProtectGetCurrentHWID(char * HWID, int Size);
|
|||
|
|
</pre>
|
|||
|
|
|
|||
|
|
<p>Первый параметр - указатель на область памяти, куда будет
|
|||
|
|
записан идентификатор. Второй параметр - размер области данных.
|
|||
|
|
Функция возвращает количество записанных байт с учетом
|
|||
|
|
завершающего нуля ('\0'). Если вместо первого параметра подать
|
|||
|
|
NULL, то функция вернет необходимое количество байт для записи
|
|||
|
|
номера. Наиболее правильный способ вызова функции следующий:</p>
|
|||
|
|
<pre class="code"><strong>int</strong> nSize = <strong>VMProtectGetCurrentHWID</strong>(NULL, 0); // получим необходимый размер буфера
|
|||
|
|
<strong>char *</strong>pBuf = <strong>new char</strong>[nSize]; // выделим буфер
|
|||
|
|
<strong>VMProtectGetCurrentHWID</strong>(pBuf, nSize); // получим идентификатор
|
|||
|
|
// используем его
|
|||
|
|
<strong>delete</strong> [] pBuf; // освободим память
|
|||
|
|
</pre><br />
|
|||
|
|
<br />
|
|||
|
|
<br />
|
|||
|
|
<br />
|
|||
|
|
<br />
|
|||
|
|
<hr noshade="noshade" size="1" />
|
|||
|
|
|
|||
|
|
<div align="center">
|
|||
|
|
© 2006-2015 Copyright VMProtect Software
|
|||
|
|
</div>
|
|||
|
|
</body>
|
|||
|
|
</html>
|