MSL: функція mSetAdvOptions, змінити налаштування показу HTML-банеру у програмах користувачів
Змінити параметри показу рекламного HTML-банера в клієнтських програмах. Усі зміни застосовуються миттєво, перезавантаження сервера чи клієнтів не потрібен.
Синтаксис
function mSetAdvOptions(bEnable: boolean; sAdvLink: string; iAdvHeight, iAdvQuantity: integer): integer;
Параметри та значення, що повертаються
|
Параметр |
Тип |
Значення |
|
bEnable |
boolean |
увімкнений чи вимкнений банер в даний момент; |
|
sAdvLink |
string |
ім'я файлу або http(s) посилання для банера; |
|
iAdvHeight |
integer |
розмір банера у точках по вертикалі; |
|
iAdvQuantity |
integer |
частота, з якою програма користувача повинна оновлювати банер із сервера, у хвилинах. |
Результат функції
|
0 |
все ок, налаштування збережені; |
|
-1 |
ви використовуєте безкоштовну версію сервера та не можете змінювати ці налаштування; |
|
-2 |
висота банера має бути в діапазоні від 0 до 400 пікселів; |
|
-3 |
частота оновлення банера має бути більшою за нуль; |
|
-4 |
посилання на банер не може бути порожнім; |
|
-5 |
вказаний html-файл немає; |
|
-6 |
вказане неправильне ім'я файлу для банера (в назві є заборонені символи). |
Приклад
begin
mSetAdvOptions(true, 'example.html', 60, 90);
end.