1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
|
<!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>
|
