MyChat Scripts: функция mPersonalContactsRefresh, обновить список личных контактов пользователя
Обновить список личных контактов у пользователя в клиентских приложениях.
Если пользователь онлайн, то имеет смысл вызывать эту функцию сразу после того, как вы делали какие-то изменения в личном списке контактов человека, чтобы изменения отобразились в MyChat Client, без его перезапуска или пересоединения с сервером.
Синтаксис
function mPersonalContactsRefresh(iUINOwner: integer): integer;
Параметры и возвращаемые значения
Параметр |
Тип |
Значение |
iUINOwner |
integer |
уникальный идентификатор пользователя, >0. |
Результат функции
0 |
список личных контактов пользователя обновлён у всех онлайн-пользователей; |
-8 |
вы не можете использовать UIN = 0; |
-5 |
пользователь не зарегистрирован на сервере; |
-28 |
пользователь не подключен к серверу (офлайн). |
Пример
const
UIN_OWNER = 6;
var
iResult: integer;
sMsg: string;
begin
iResult := mPersonalContactsRefresh(UIN_OWNER);
case iResult of
1: sMsg := 'all ok, contact list refreshed';
-8: sMsg := 'you can''t use UIN = 0';
-5: sMsg := 'owner uin does not exist';
-28: sMsg := 'owner uin is offline';
end;
mLogScript(sMsg, '');
end.
Результат работы скрипта
[18:26:12] (Log "mPersonalContactsRefresh"): all ok, contact list refreshed
[18:26:12] (Run "mPersonalContactsRefresh"): Время выполнения скрипта: 5 мс
[18:26:12] (Run "mPersonalContactsRefresh"): Скрипт выполнен успешно.