DPA_Search 函式 (dpa_dsa.h)

  • 發行項

[DPA_Search 可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]

尋找動態指標陣列中的專案， (DPA) 。

語法

int DPA_Search(
  HDPA         hdpa,
  void         *pFind,
  int          iStart,
  PFNDACOMPARE pfnCompare,
  LPARAM       lParam,
  UINT         options
);

參數

hdpa

類型： HDPA

DPA 的句柄。

pFind

類型： void*

要搜尋的指標。

iStart

類型： int

要開始搜尋的索引。

pfnCompare

類型： PFNDPACOMPARE

比較函式指標。 如需比較函式原型，請參閱 PFNDPACOMPARE 。

lParam

類型： LPARAM

要傳遞至 pfnCmp 的其他參數。

options

類型： UINT

此參數可以是下列其中一或多個參數。

值 意義
DPAS_SORTED
 表示已排序 DPA。
DPAS_INSERTBEFORE
 這個值只能與DPAS_SORTED搭配使用。 如果找不到專案，則傳回項目預期在已排序的 DPA 中找到的位置。
DPAS_INSERTAFTER
 這個值只能與DPAS_SORTED搭配使用。 如果找不到專案，則傳回項目預期在已排序的 DPA 中找到的位置。

傳回值

類型： int

傳回在 DPA 中找到專案的索引，如果 -1 找不到專案，則傳回索引。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 dpa_dsa.h
程式庫 Comctl32.lib
Dll ComCtl32.dll
API 集合 ext-ms-win-shell-comctl32-da-l1-1-0 (Windows 10 10.0.14393 版)