first commit

Version 3.x.x
2025-08-03 10:20:13 +03:00 · 2023-05-14 20:21:09 +07:00
parent a3037a8db3
commit 5ec92ee05e
1166 changed files with 1036539 additions and 0 deletions
--- a/help/ru/manager/activation/api.htm
+++ b/help/ru/manager/activation/api.htm
@@ -0,0 +1,223 @@
+<!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>