MyChat Scripts: функция mKillUIN, отключить онлайн-пользователя от сервера
"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mKillUIN".
Функция для отключения от сервера всех онлайн-приложений, залогиненных на сервере под указанным UIN.
Как правило, все приложения MyChat, кроме WEB-сервисов (канбан, форум, веб-чат,MyChat Guest и консоль управления сервером), автоматически переподключаются к серверу после разрыва соединения.
Синтаксис
function mKillUIN(iUIN: integer): integer;
Параметры и возвращаемые значения
|
Параметр |
Тип |
Значение |
|
iUIN |
integer |
уникальный идентификатор пользователя. |
Результат функции
|
>0 |
всё ок, пользователь офлайн, результат равен количеству отключенных instance пользователей от сервера; |
|
-1 |
вы не можете отключить от сервера встроенного робота UIN 0; |
|
-2 |
UIN должен быть больше нуля; |
|
-3 |
указанный пользователь сейчас отключен от сервера (офлайн). |
Пример
Скрипт для мгновенного отключения всех онлайн-пользователей от сервера MyChat.
const
STATE_ONLINE = 0;
var
sUsers: string;
iUIN: integer;
begin
sUsers := mGetUsersListByState(STATE_ONLINE);
while length(sUsers) > 0 do begin
iUIN := StrToIntDef(Fetch(sUsers, ','), -1);
if iUIN > 0 then mKillUIN(iUIN);
end;
end.
Результат работы скрипта
