通过

DPA_SortedInsertPtr宏 （dpa_dsa.h）

  • 项目

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

语法

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

参数

hdpa

类型：HDPA

DPA 的句柄。

pFind

类型：void*

一个项指针，用于确定新项目的插入点（请参阅备注）。

iStart

类型：int

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

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