206 lines
11 KiB
HTML
206 lines
11 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>Функции SDK</title>
|
||
</head>
|
||
|
||
<body>
|
||
<h1>Функции SDK</h1>
|
||
|
||
<p>Функции SDK предназначены для интеграции в исходный код
|
||
защищаемого приложения и служат для задания границ защищаемых
|
||
областей, обнаружения использования средств отладки или
|
||
виртуализации.</p>
|
||
|
||
<p><strong>Маркеры кода</strong></p>
|
||
|
||
<ul>
|
||
<li><a href="#VMProtectBegin">VMProtectBegin</a></li>
|
||
<li><a href="#VMProtectBeginVirtualization">VMProtectBeginVirtualization</a></li>
|
||
<li><a href="#VMProtectBeginMutation">VMProtectBeginMutation</a></li>
|
||
<li><a href="#VMProtectBeginUltra">VMProtectBeginUltra</a></li>
|
||
<li><a href="#VMProtectBeginVirtualizationLockByKey">VMProtectBeginVirtualizationLockByKey</a></li>
|
||
<li><a href="#VMProtectBeginUltraLockByKey">VMProtectBeginUltraLockByKey</a></li>
|
||
<li><a href="#VMProtectEnd">VMProtectEnd</a></li>
|
||
</ul>
|
||
|
||
<p><strong>Сервисные функции</strong></p>
|
||
|
||
<ul>
|
||
<li><a href="#VMProtectIsProtected">VMProtectIsProtected</a></li>
|
||
<li><a href="#VMProtectIsDebuggerPresent">VMProtectIsDebuggerPresent</a></li>
|
||
<li><a href="#VMProtectIsVirtualMachinePresent">VMProtectIsVirtualMachinePresent</a></li>
|
||
<li><a href="#VMProtectIsValidImageCRC">VMProtectIsValidImageCRC</a></li>
|
||
<li><a href="#VMProtectDecryptStringA">VMProtectDecryptStringA</a></li>
|
||
<li><a href="#VMProtectDecryptStringW">VMProtectDecryptStringW</a></li>
|
||
<li><a href="#VMProtectFreeString">VMProtectFreeString</a></li>
|
||
</ul>
|
||
|
||
<p><strong>Функции лицензирования</strong></p>
|
||
|
||
<ul>
|
||
<li><a href="manager/usage/api.htm">VMProtectSetSerialNumber</a></li>
|
||
<li><a href="manager/usage/api.htm">VMProtectGetSerialNumberState</a></li>
|
||
<li><a href="manager/usage/api.htm">VMProtectGetSerialNumberData</a></li>
|
||
<li><a href= "manager/usage/api.htm">VMProtectGetCurrentHWID</a></li>
|
||
</ul>
|
||
|
||
<p id="VMProtectBegin"><strong>VMProtectBegin</strong></p>
|
||
<pre class="code">void VMProtectBegin(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p><a href="use_markers.htm">Маркер</a> начала защищаемой области
|
||
кода. Вызов VMProtectBegin должен находиться перед первой
|
||
командой (вызовом процедуры, функции) защищаемого блока кода.
|
||
MarkerName задает имя маркера, которое в VMProtect будет иметь
|
||
вид "VMProtectMarker"+MarkerNamе. Например, маркер
|
||
VMProtectBegin('CheckRegistration') будет выглядеть как
|
||
VMProtectMarker "CheckRegistration". Если имя маркера не задано,
|
||
ему будет присвоено уникальное имя вида "VMProtectMarker"+номер
|
||
маркера по порядку. <a href=
|
||
"project_functions.htm#CompilationTypes">Тип компиляции</a>
|
||
защищаемой области задается при обработке проекта в
|
||
VMProtect.</p>
|
||
|
||
<p id="VMProtectBeginVirtualization"><strong>VMProtectBeginVirtualization</strong></p>
|
||
<pre class="code">void VMProtectBeginVirtualization(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p>Маркер начала защищаемой области кода с предустановленным
|
||
типом компиляции "виртуализация". MarkerName задает <a href="#VMProtectBegin">имя маркера</a>.
|
||
При дальнейшей работе с VMProtect тип
|
||
компиляции, заданный маркером, изменить нельзя.</p>
|
||
|
||
<p id="VMProtectBeginMutation"><strong>VMProtectBeginMutation</strong></p>
|
||
<pre class="code">void VMProtectBeginMutation(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p>Маркер начала защищаемой области кода с предустановленным
|
||
типом компиляции "мутация". MarkerName задает <a href="#VMProtectBegin">имя маркера</a>.
|
||
При дальнейшей работе с VMProtect тип компиляции,
|
||
заданный маркером изменить, нельзя.</p>
|
||
|
||
<p id="VMProtectBeginUltra"><strong>VMProtectBeginUltra</strong></p>
|
||
<pre class="code">void VMProtectBeginUltra(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p>Маркер начала защищаемой области кода с предустановленным
|
||
типом компиляции "ультра (мутация + виртуализация)". MarkerName
|
||
задает <a href="#VMProtectBegin">имя маркера</a>. При дальнейшей работе с
|
||
VMProtect тип компиляции, заданный маркером, изменить
|
||
нельзя.</p>
|
||
|
||
<p id="VMProtectBeginVirtualizationLockByKey"><strong>VMProtectBeginVirtualizationByKey</strong></p>
|
||
<pre class="code">void VMProtectBeginVirtualizationLockByKey(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p>Маркер начала защищаемой области кода с предустановленным
|
||
типом компиляции "виртуализация" и опцией "<a href=
|
||
"project_functions.htm#LockToKey">Привязать к ключу</a>".
|
||
MarkerName задает <a href="#VMProtectBegin">имя маркера</a>. При
|
||
дальнейшей работе с VMProtect тип компиляции, заданный маркером,
|
||
изменить нельзя.</p>
|
||
|
||
<p id="VMProtectBeginUltraLockByKey"><strong>VMProtectBeginUltraLockByKey</strong></p>
|
||
<pre class="code">void VMProtectBeginUltraLockByKey(const char *MarkerName);
|
||
</pre>
|
||
|
||
<p>Маркер начала защищаемой области кода с предустановленным
|
||
типом компиляции "ультра (мутация + виртуализация)" и опцией
|
||
"<a href="project_functions.htm#LockToKey">Привязать к
|
||
ключу</a>". MarkerName задает <a href="#VMProtectBegin">имя маркера</a>.
|
||
При дальнейшей работе с VMProtect тип компиляции, заданный
|
||
маркером, изменить нельзя.</p>
|
||
|
||
<p id="VMProtectEnd"><strong>VMProtectEnd</strong></p>
|
||
<pre class="code">void VMProtectEnd(void);
|
||
</pre>
|
||
|
||
<p>Маркер конца защищаемой области кода. Вызов VMProtectEnd
|
||
должен находиться после последней команды (вызова процедуры,
|
||
функции) защищаемого блока кода.</p>
|
||
|
||
<p id="VMProtectIsProtected"><strong>VMProtectIsProtected</strong></p>
|
||
<pre class="code">bool VMProtectIsProtected(void);
|
||
</pre>
|
||
|
||
<p>Функция MProtectIsProtected возвращает True если файл обработан VMProtect.</p>
|
||
|
||
<p id="VMProtectIsDebuggerPresent"><strong>VMProtectIsDebuggerPresent</strong></p>
|
||
<pre class="code">bool VMProtectIsDebuggerPresent(bool CheckKernelMode);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectIsDebuggerPresent позволяет определить факт
|
||
запуска приложения из-под отладчика. Результат ее работы
|
||
(True/False) может быть обработан с помощью защитных механизмов,
|
||
встроенных в приложение. При CheckKernelMode=False функция
|
||
проверяет наличие отладчика User-mode (OllyDBG, WinDBG и т.п.).
|
||
При CheckKernelMode=True будет производиться определение как
|
||
отладчиков User-mode, так и отладчиков Kernel-mode (SoftICE,
|
||
Syser и т.п.). При защите драйверов значение CheckKernelMode не
|
||
имеет значения, так как драйвера работают в режиме ядра, поэтому
|
||
для них всегда проверяется наличие отладчиков
|
||
Kernel-mode.</p>
|
||
|
||
<p id="VMProtectIsVirtualMachinePresent"><strong>VMProtectIsVirtualMachinePresent</strong></p>
|
||
<pre class="code">bool VMProtectIsVirtualMachinePresent(void);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectIsVirtualMachinePresent позволяет определить
|
||
факт запуска приложения в виртуальной среде: VMware, Virtual PC,
|
||
VirtualBox, Sandboxie. Результат ее работы (True/False) может
|
||
быть обработан с помощью защитных механизмов, встроенных в
|
||
приложение.</p>
|
||
|
||
<p id="VMProtectIsValidImageCRC"><strong>VMProtectIsValidImageCRC</strong></p>
|
||
<pre class="code">bool VMProtectIsValidImageCRC(void);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectIsValidImageCRC позволяет определить факт
|
||
изменения защищенного модуля в памяти процесса (проверяются только неизменяемые сегменты кода и данных).
|
||
Результат ее работы (True/False) может быть обработан с помощью защитных механизмов, встроенных в
|
||
приложение.</p>
|
||
|
||
<p id="VMProtectDecryptStringA"><strong>VMProtectDecryptStringA</strong></p>
|
||
<pre class="code">const char * VMProtectDecryptStringA(const char *Value);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectDecryptStringA позволяет дешифровать
|
||
строковую ANSI константу Value. Для шифрации константы её
|
||
необходимо <a href="project_functions.htm#AddFunction">включить
|
||
в список защищаемых объектов</a>.</p>
|
||
|
||
<p id="VMProtectDecryptStringW"><strong>VMProtectDecryptStringW</strong></p>
|
||
<pre class="code">const wchar_t * VMProtectDecryptStringW(const wchar_t *Value);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectDecryptStringW позволяет дешифровать
|
||
строковую Unicode константу Value. Для шифрации константы её
|
||
необходимо <a href="project_functions.htm#AddFunction">включить
|
||
в список защищаемых объектов</a>.</p>
|
||
|
||
<p id="VMProtectFreeString"><strong>VMProtectFreeString</strong></p>
|
||
<pre class="code">bool VMProtectFreeString(const void *Value);
|
||
</pre>
|
||
|
||
<p>Функция VMProtectFreeString освобождает динамическую память, занятую расшифрованной строкой. Освобождение делать не обязательно, но если делать - то только этой функцией.
|
||
Повторное использование VMProtectDecryptStringA/VMProtectDecryptStringW с тем же параметром и без уничтожения ранее
|
||
расшифрованной строки не будет приводить к дополнительному выделению памяти.</p><br />
|
||
<br />
|
||
<br />
|
||
<br />
|
||
<br />
|
||
<hr noshade="noshade" size="1" />
|
||
|
||
<div align="center">
|
||
© 2006-2015 Copyright VMProtect Software
|
||
</div>
|
||
</body>
|
||
</html>
|