MyChat Scripts: функция mHaltlCID, завершить работу удалённого приложения MyChat Client
"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mHaltCID".
Функция для завершения работы удалённого приложения MyChat Client по его соединению (Connection ID). Клиентское приложение получает эту команду, отключается от сервера и выгружается из памяти.
Синтаксис
function mHaltCID(const iCID: int64): integer;
Параметры и возвращаемые значения
Параметр |
Тип |
Значение |
iCID |
int64 |
уникальный идентификатор соединения. |
Результат функции
0 |
всё ок, соединение успешно разорвано; |
-1 |
неизвестный ли неправильный CID; |
-2 |
CID должен быть больше нуля. |
Пример
Скрипт для завершения работы всех Android-приложений, подключенных к серверу MyChat.
var
sCIDList: string;
iCount: integer;
begin
iCount := 0;
sCIDList := mGetCIDSByClientType('android');
while length(sCIDList) > 0 do
if mHaltCID(StrToInt64(Fetch(sCIDList, ','))) = 0 then inc(iCount);
mLogScript('Total MyChat Android apps halted: ' + IntToStr(iCount), '');
end.
Результат работы скрипта
[17:35:35] (Log "mHaltCID"): Total MyChat Android apps halted: 94
[17:35:35] (Run "mHaltCID"): Время выполнения скрипта: 529 мс
[17:35:35] (Run "mHaltCID"): Скрипт выполнен успешно.