Функция DSA_InsertItem (dpa_dsa.h)

[DSA_InsertItem доступно для использования в операционной системе

системы, указанные в разделе Требования. Он может быть изменен или недоступен в

последующие версии.]

Вставляет новый элемент в массив динамической структуры (DSA). При необходимости DSA расширяется для размещения нового элемента.

Синтаксис

int DSA_InsertItem(
  [in] HDSA       hdsa,
  [in] int        i,
  [in] const void *pitem
);

Параметры

[in] hdsa

Тип: HDSA

Дескриптор DSA, в который вставляется элемент.

[in] i

Тип: int

Позиция в DSA, в которой должен быть вставлен новый элемент, или DSA_APPEND, чтобы вставить элемент в конце массива.

[in] pitem

Тип: void*

Указатель на вставляемый элемент.

Возвращаемое значение

Тип: int

Возвращает индекс нового элемента, если вставка выполнена успешно, или DSA_ERR (-1) в случае сбоя вставки.

Комментарии

Фактические данные, на которые указывает pItem, копируются в DSA. Последующие действия, выполняемые с этим элементом, не влияют на исходную копию.

Требования