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