|
InsertList |
  
|
|
InsertList |
|
Добавление одного или нескольких элементов в список.
C/C++ -
HRESULT _stdcall InsertList([in] enum APIListType List, [in] VARIANT Index, [in] VARIANT xml);
Delphi -
procedure InsertList(List: APIListType; Index: OleVariant; xml: OleVariant); safecall;
Параметры
List
Тип списка, перечисление APIListType.
XML
XML данные в текстовом виде. Эти данные проверяются на соответствие XML схеме, если что-то не так, то возвращается ошибка (исключение). Для элементов списка атрибут GUID опционален: если он не задан, то будет создан программой. Если GUID задан и элемент с таким GUID уже есть, то возвращается ошибка (исключение).
Некоторые другие атрибуты в списках могут быть обязательны, например DisplayName.
В качестве корневого элемента в XML данных может быть элемент всего списка или одиночный элемент. В первом случае одним запросом можно сразу добавлять несколько элементов списка, во втором - добавляется один элемент.
Пример использования
См. пример использования в описании функции UpdateList.
Текущая страница справки: http://help.smart-soft.ru/doc20/index.html?sdk_insertlist.htm