DPA_SortedInsertPtr Makro (dpa_dsa.h)

Artikel
10/24/2024

Fügt ein neues Element vor oder nach einem angegebenen vorhandenen Element ein.

Syntax

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

Parameter

hdpa

Typ: HDPA-

Ein Handle zu einem DPA.

pFind

Typ: void*

Ein Elementzeiger, der zum Bestimmen der Einfügemarke für das neue Element verwendet wird (siehe Hinweise).

iStart

Typ: int

Der Index in der DPA, bei dem die Suche nach pFindbeginnen soll.

pfnCompare

Typ: PFNDPACOMPARE

Ein Zeiger auf die Vergleichsfunktion. Siehe PFNDPACOMPARE oder PFNDPACOMPARECONST für den Vergleichsfunktionsprototyp.

lParam

Typ: LPARAM-

Ein zusätzlicher Parameter, der verwendet wird, um Informationen an die Vergleichsfunktion zu übergeben, auf die durch pfnCompareverwiesen wird.

options

Typ: UINT-

Die Einfügemarke. Muss einer der folgenden Werte sein:

Wert	Bedeutung
DPAS_INSERTBEFORE	Fügen Sie das neue Element vor dem pFind Element ein.
DPAS_INSERTAFTER	Fügen Sie das neue Element nach dem pFind Element ein.

pitem

Typ: void*

Ein Zeiger auf das Element, das eingefügt werden soll.

Rückgabewert

Typ: int

Gibt den Index des neuen Elements oder -1 zurück, wenn die Einfügeaktion fehlschlägt.

Bemerkungen

Hinweis Dieses Makro umschließt die funktionen DPA_InsertPtr und DPA_Search.

Das DPAS_SORTED Flag ist standardmäßig in Optionen enthalten um anzugeben, dass der DPA sortiert ist.

Weitere Informationen dazu, wie sich das pFind--Element befindet, finden Sie in der Funktion DPA_Search. Das neue Element wird vor oder nach dem pFind Element gemäß den Optionen Parameter eingefügt. Der pFind Parameter muss im DPA nicht vorhanden sein. Wenn es in der DPA nicht vorhanden ist, wird das neue Element eingefügt, in dem pFind in sortierter Reihenfolge in der DPA eingefügt worden wäre.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	dpa_dsa.h

Freigeben über