DPA_SortedInsertPtr 宏 (dpa_dsa.h)

  • 项目

在指定的现有项之前或之后插入新项。

语法

void DPA_SortedInsertPtr(
   hdpa,
   pFind,
   iStart,
   pfnCompare,
   lParam,
   options,
   pitem
);

参数

hdpa

类型： HDPA

DPA 的句柄。

pFind

类型： void*

项指针，用于确定新项的插入点 (请参阅备注) 。

iStart

类型： int

要开始搜索 pFind 的 DPA 中的索引。

pfnCompare

类型： PFNDPACOMPARE

指向比较函数的指针。 有关比较函数原型，请参阅 PFNDPACOMPARE 或 PFNDPACOMPARECONST 。

lParam

类型： LPARAM

用于将信息传递给 pfnCmp 指向的比较函数的附加参数。

options

类型： UINT

插入点。 必须是以下值之一。

值 含义
DPAS_INSERTBEFORE
 在 pFind 项之前插入新项。
DPAS_INSERTAFTER
 在 pFind 项之后插入新项。

pitem

类型： void*

指向要插入的项的指针。

返回值

无

备注

注意 此宏包装 DPA_InsertPtr 和 DPA_Search 函数。
 
默认情况下，DPAS_SORTED标志包含在 选项 中，以指示 DPA 已排序。

有关 pFind 项定位方式的其他信息，请参阅函数DPA_Search。 根据 options 参数在 pFind 项之前或之后插入新项。 pFind 参数不需要存在于 DPA 中。 如果 DPA 中不存在新项，则会在 pFind 按排序顺序插入 DPA 时插入新项。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 dpa_dsa.h