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.