макрос DPA_SortedInsertPtr (dpa_dsa.h)

Статья
10/24/2024

Вставляет новый элемент до или после указанного существующего элемента.

Синтаксис

int DPA_SortedInsertPtr(
   HDPA          hdpa,
   void          *pFind,
   int           iStart,
   PFNDPACOMPARE pfnCompare,
   LPARAM        lParam,
   UINT          options,
   void          *pitem
);

Параметры

hdpa

Тип: HDPA

Дескриптор DPA.

pFind

Тип: void*

Указатель элемента, используемый для определения точки вставки нового элемента (см. примечания).

iStart

Тип: int

Индекс в DPA, с которого начинается поиск pFind.

pfnCompare

Тип: PFNDPACOMPARE

Указатель на функцию сравнения. См. PFNDPACOMPARE или PFNDPACOMPARECONST для прототипа функции сравнения.

lParam

Тип: LPARAM

Дополнительный параметр, используемый для передачи информации в функцию сравнения, на которую указывает pfnCompare.

options

Тип: UINT

Точка вставки. Должно быть одним из следующих значений.

Ценность	Значение
DPAS_INSERTBEFORE	Вставьте новый элемент перед элементом pFind.
DPAS_INSERTAFTER	Вставьте новый элемент после элемента pFind.

pitem

Тип: void*

Указатель на элемент, который нужно вставить.

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

Тип: int

Возвращает индекс нового элемента или -1, если действие вставки завершается ошибкой.

Замечания

примечание Этот макрос упаковывает функции DPA_InsertPtr и DPA_Search.

Флаг DPAS_SORTED включен в параметры по умолчанию, чтобы указать, что DPA отсортирован.

Дополнительные сведения о расположении элемента pFind см. в DPA_Search функции. Новый элемент вставляется до или после pFind элемента в соответствии с параметрами . Параметр pFind не должен существовать в DPA. Если он не существует в DPA, то новый элемент вставляется, где pFind было бы вставлено в DPA в отсортированном порядке.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	dpa_dsa.h

Поделиться через