MyChat Scripts: функция mKillCID, разорвать подключение онлайн-приложения
"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mKillCID".
Функция для отключения от сервера одного соединения. Соединение — это instance приложения или сервиса MyChat.
Как правило, все приложения MyChat, кроме WEB-сервисов (канбан, форум, веб-чат,MyChat Guest и консоль управления сервером), автоматически переподключаются к серверу после разрыва соединения.
Синтаксис
function mKillCID(iCID: int64): integer;
Параметры и возвращаемые значения
|
Параметр |
Тип |
Значение |
|
iCID |
int64 |
уникальный идентификатор соединения. |
Результат функции
|
0 |
всё ок, соединение успешно разорвано; |
|
-1 |
неизвестный ли неправильный CID; |
|
-2 |
CID должен быть больше нуля. |
Пример
Скрипт для мгновенного отключения всех пользователей встроенного форума и системы управления проектами Kanban.
var
sCIDList: string;
iCount: integer;
begin
iCount := 0;
sCIDList := mGetCIDSByClientType('forum,kanban');
while length(sCIDList) > 0 do
if mKillCID(StrToInt64(Fetch(sCIDList, ','))) = 0 then inc(iCount);
mLogScript('Disconnected: ' + IntToStr(iCount) + ' web applications', '');
end.
Результат работы скрипта
[00:06:17] (Log "mKillCID"): Disconnected: 2 web applications
[00:06:17] (Run "mKillCID"): Время выполнения скрипта: 22 мс
[00:06:17] (Run "mKillCID"): Скрипт выполнен успешно.