DPA_Search-Funktion (dpa_dsa.h)

[DPA_Search ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Sucht ein Element in einem dynamischen Zeigerarray (DPA).

Syntax

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

Parameter

hdpa

Typ: HDPA

Ein Handle für eine DPA.

pFind

Typ: void*

Ein zeiger, nach dem gesucht werden soll.

iStart

Typ: int

Der Index, an dem die Suche gestartet werden soll.

pfnCompare

Typ: PFNDPACOMPARE

Ein Vergleichsfunktionszeiger. Den Vergleichsfunktionsprototyp finden Sie unter PFNDPACOMPARE .

lParam

Typ: LPARAM

Ein zusätzlicher Parameter, der an pfnCmp übergeben werden soll.

options

Typ: UINT

Dieser Parameter kann einer oder mehrere der folgenden Parameter sein.

Wert	Bedeutung
DPAS_SORTED	Gibt an, dass die DPA sortiert ist.
DPAS_INSERTBEFORE	Dieser Wert ist nur in Verbindung mit DPAS_SORTED gültig. Wenn das Element nicht gefunden wird, geben Sie die Position zurück, an der das Element in der sortierten DPA zu finden ist.
DPAS_INSERTAFTER	Dieser Wert ist nur in Verbindung mit DPAS_SORTED gültig. Wenn das Element nicht gefunden wird, geben Sie die Position zurück, an der das Element in der sortierten DPA zu finden ist.

Rückgabewert

Typ: int

Gibt den Index zurück, in dem das Element im DPA gefunden wurde oder -1 wenn das Element nicht gefunden wurde.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dpa_dsa.h
Bibliothek	Comctl32.lib
DLL	ComCtl32.dll
APIs	ext-ms-win-shell-comctl32-da-l1-1-0 (eingeführt in Windows 10, Version 10.0.14393)