"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "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"): Скрипт выполнен успешно.
