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

 

Рекомендуется использовать эту функцию вместо mPersonalContactsAddUser, если вам нужно добавить больше одного контакта "за раз".

 

Синтаксис

function mPersonalContactsAddUsers(const iUINOwner: integer; const sUINList, sGroupName: string): integer;

 

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

Параметр

Тип

Значение

iUINOwner

integer

уникальный идентификатор пользователя, владелец личного списка контактов, >0;

sUINList

string

список UIN-ов пользователей через запятую. Все несуществующие UIN-ы, дубликаты, а также 0 и UIN владельца списка контактов будут проигнорированы;

sGroupName

string

название группы. Нельзя использовать управляющие символы, не должно быть пустым.

 

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

>=0

количество добавленных пользователей;

-1

несуществующий UIN-владелец личного списка контактов;

-4

название группы не может быть пустым или состоящим из пробелов;

-5

название группы слишком длинное (ограничение не больше 255 символов по умолчанию);

-6

в названии группы есть недопустимые символы (CRLF, управляющие непечатные символы UNICODE или ASCII).

 

Пример

begin
  mPersonalContactsAddUsers(6, '30,534,3055,3587,3967,5454,7307,7774,7881,7899,7900', 'My department');
  mPersonalContactsRefresh(6);
end.


Ещё посмотреть

mPersonalContactsAddUser

mPersonalContactsRefresh