共用方式為

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 pFind。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 dpa_dsa.h