224 lines
10 KiB
HTML
224 lines
10 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 Активации содержит всего 4 функции. Две предназначены для
|
||
онлайн-активации и две для оффлайн, когда на компьютере
|
||
отсутствует доступ в Интернет. API Активации предназначено для
|
||
взаимодействия с Web License Manager, так что разработчику все
|
||
равно необходимо вызывать API системы лицензирования, чтобы
|
||
использовать серийные номера, полученные от WebLM.</p><strong id=
|
||
"VMProtectActivateLicense">VMProtectActivateLicense</strong>
|
||
|
||
<p>Функция передает код активации на сервер и возвращает серийный
|
||
номер, подходящий для этого конкретного компьютера. В противном
|
||
случае возвращается <a href="#codes">код ошибки</a>.</p>
|
||
<pre class="code">int VMProtectActivateLicense(const char *code, char *serial, int size);
|
||
</pre>
|
||
|
||
<p>Параметр <strong>code</strong> содержит код активации, который
|
||
получен от Web License Manager в процессе покупки лицензии.
|
||
Параметр <strong>serial</strong> указывает на блок памяти размера
|
||
<strong>size</strong>, в который будет помещен сгенерированный
|
||
WebLM серийный номер.</p><strong id=
|
||
"VMProtectDeactivateLicense">VMProtectDeactivateLicense</strong>
|
||
|
||
<p>Функция передает серийный номер на сервер для деактивации.
|
||
Возможные коды возврата перечислены <a href=
|
||
"#codes">ниже</a>.</p>
|
||
<pre class="code">int VMProtectDeactivateLicense(const char *serial);
|
||
</pre>
|
||
|
||
<p>Параметр <strong>serial</strong> содержит серийный номер (не
|
||
код активации), полученный ранее от WebLM в процессе
|
||
активации.</p><strong id=
|
||
"VMProtectGetOfflineActivationString">VMProtectGetOfflineActivationString</strong><br />
|
||
|
||
<strong id=
|
||
"VMProtectGetOfflineDeactivationString">VMProtectGetOfflineDeactivationString</strong>
|
||
|
||
<p>Эти две функции работают практически аналогично двум
|
||
предыдущим с той лишь разницей, что они не пытаются подключиться
|
||
к серверу WebLM. Вместо этого они возвращают блок текста, который
|
||
необходимо скопировать на компьютер где есть доступ в Интернет,
|
||
открыть там форму оффлайн-активации WebLM и вставить туда этот
|
||
текст.</p>
|
||
<pre class="code">int VMProtectGetOfflineActivationString(const char *code, char *buf, int size);
|
||
int VMProtectGetOfflineDeactivationString(const char *serial, char *buf, int size);
|
||
</pre>
|
||
|
||
<p>Параметры <strong>code</strong> и <strong>serial</strong>
|
||
аналогичны параметрам онлайн-версий функций, параметр
|
||
<strong>buf</strong> должен указывать на буфер размером 1000 байт
|
||
или больше, туда будет скопирован текстовый блок для формы
|
||
оффлайн-активации. Возможные коды ошибок перечислены <a href=
|
||
"#codes">ниже</a>.</p>
|
||
|
||
<h3 id="codes">Возможные Коды Ошибок</h3>
|
||
|
||
<table border="1" cellspacing="0" cellpadding="2">
|
||
<tr>
|
||
<th>Код</th>
|
||
|
||
<th>Значение</th>
|
||
|
||
<th>Описание</th>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_OK</td>
|
||
|
||
<td>0</td>
|
||
|
||
<td>Активация прошла успешно, переменная
|
||
<strong>serial</strong> содержит серийный номер.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_SMALL_BUFFER</td>
|
||
|
||
<td>1</td>
|
||
|
||
<td>Буфер для серийного номера слишком маленький. Минимальный
|
||
размер буфера вычисляется по формуле: bits / 8 * 3 / 2 + N,
|
||
где bits - длина RSA ключа в битах, а N - "константа
|
||
безопасности" - дополнительное количество байт на случай
|
||
переносов строк и прочих спец-символов. Рекомендуется
|
||
использовать как минимум 10.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_NO_CONNECTION</td>
|
||
|
||
<td>2</td>
|
||
|
||
<td>Модуль активации не смог подключиться к Web License
|
||
Manager.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_BAD_REPLY</td>
|
||
|
||
<td>3</td>
|
||
|
||
<td>Сервер активации вернул неожиданный результат. Это
|
||
означает проблемы конфигурации сервера, неправильный url
|
||
сервера активации или попытку взлома.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_BANNED</td>
|
||
|
||
<td>4</td>
|
||
|
||
<td>Этот код активации заблокирован на сервере производителем
|
||
ПО через интерфейс WebLM (например, из-за
|
||
утечки кода активации с пиратской копией). Не путать с ACTIVATION_ALREADY_USED.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_CORRUPTED</td>
|
||
|
||
<td>5</td>
|
||
|
||
<td>Что-то пошло совсем не так. Ошибка выдается системой
|
||
самопроверки модуля активации и с высокой вероятностью
|
||
означает попытку взлома. В случае получения этой ошибки
|
||
дальнейшие операции с серийными номерами и активацией не
|
||
могут считаться безопасными.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_BAD_CODE</td>
|
||
|
||
<td>6</td>
|
||
|
||
<td>Данный код не найден в базе данных сервера активаций.
|
||
Возможно пользователь ошибся при вводе кода, так что можно
|
||
попросить его проверить правильность ввода данных.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_ALREADY_USED</td>
|
||
|
||
<td>7</td>
|
||
|
||
<td>Счетчик активаций этого кода дошел до нуля и дальнейшие
|
||
активации невозможны. Это не обозначает, что код плохой или
|
||
заблокирован - код хороший. Пользователю нужно связаться с
|
||
производителем ПО и докупить необходимое количество лицензий
|
||
или же деинсталлировать программу на других компьютерах,
|
||
чтобы увеличить значение счетчика в базе данных.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_SERIAL_UNKNOWN</td>
|
||
|
||
<td>8</td>
|
||
|
||
<td>Ошибка деактивации. Означает, что данный серийный
|
||
номер не найден в базе данных сервера. Соответственно,
|
||
деактивация не может быть проведена успешно.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_EXPIRED</td>
|
||
|
||
<td>9</td>
|
||
|
||
<td>Ошибка активации. Означает, что период действия кода активации истек.</td>
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>ACTIVATION_NOT_AVAILABLE</td>
|
||
|
||
<td>10</td>
|
||
|
||
<td>Ошибка означает, что активация/деактивация недоступна.</td>
|
||
</tr>
|
||
|
||
</table>
|
||
|
||
<h3>Маленькие хитрости</h3>
|
||
|
||
<p>API Активации достаточно простое, так что с ним не должно
|
||
возникнуть сложностей. Не забудьте предоставить пользователям
|
||
интерфейс для оффлайн-активации, если онлайн-активация
|
||
завершилась неудачей из-за проблем с доступом в интернет. Также
|
||
не забывайте, что API Активации не сохраняет полученный серийный
|
||
номер и не передает его модулю лицензирования - это задача
|
||
разработчика. Нет необходимости вызывать API Активации при каждом
|
||
запуске приложения - достаточно вызвать его один раз, получить
|
||
серийный номер от WebLM, сохранить его в удобном месте и в
|
||
дальнейшем использовать только его.</p><br />
|
||
<br />
|
||
<br />
|
||
<br />
|
||
<br />
|
||
<hr noshade="noshade" size="1" />
|
||
|
||
<div align="center">
|
||
© 2006-2015 Copyright VMProtect Software
|
||
</div>
|
||
</body>
|
||
</html>
|