Для разработчиков > Серверные скрипты > Описание функций > Пользователи

"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mHaltUIN".

Отключить от сервера любого онлайн-пользователя и принудительно завершить работу всех экземпляров его подключенных приложений.

Синтаксис

function mHaltUIN(iUIN: integer): integer;

Параметры и возвращаемые значения

Параметр	Тип	Значение
iUIN	integer	уникальный идентификатор онлайн-пользователя.

Результат функции

>0	всё ок, отключено N соединений;
-1	вы не можете завершить работу встроенного бота (UIN 0);
-2	UIN должен быть больше нуля;
-3	указанный пользователь отключен от сервера (офлайн).

Пример

Функция отключает от сервера и завершает работу всех подключенных приложений пользователей указанной группы.

const
  GROUP_NAME = 'External users';
var
  SL: TStringList;
  i, iUIN, iCount: integer;
begin
  SL := TStringList.Create;
  SL.CommaText := mGetUsersListInGroupByName(GROUP_NAME);
  
    if SL.Count > 0 then begin
      iCount := 0;
      
        for i := 0 to SL.Count - 1 do begin
          iUIN := StrToInt(SL[i]);
          
            if mIsUINOnline(iUIN) then begin
              mHaltUIN(iUIN);
              inc(iCount);
            end;  
        end;  
    end;  
    
  SL.Free;
  
    if iCount > 0 then mLogScript('Halted ' + IntToStr(iCount) + ' users', '');    
end.