DPA_SortedInsertPtr Makro (dpa_dsa.h)

Artikel
08/23/2023

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

Syntax

void DPA_SortedInsertPtr(
   hdpa,
   pFind,
   iStart,
   pfnCompare,
   lParam,
   options,
   pitem
);

Parameter

hdpa

Typ: HDPA

Ein Handle für eine DPA.

pFind

Typ: void*

Ein Elementzeiger, der verwendet wird, um die Einfügemarke für das neue Element zu bestimmen (siehe Hinweise).

iStart

Typ: int

Der Index im DPA, an dem mit der Suche nach pFind begonnen werden soll.

pfnCompare

Typ: PFNDPACOMPARE

Ein Zeiger auf die Vergleichsfunktion. Informationen zum Prototyp der Vergleichsfunktion finden Sie unter PFNDPACOMPARE ODER PFNDPACOMPARECONST .

lParam

Typ: LPARAM

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

options

Typ: UINT

Die Einfügemarke. Dabei muss es sich um einen der folgenden Werte handeln.

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

Keine

Bemerkungen

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

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

Weitere Informationen zur Position des pFind-Elements finden Sie unter Funktions-DPA_Search. Das neue Element wird vor oder nach dem pFind-Element gemäß dem Optionsparameter eingefügt. Der pFind-Parameter muss im DPA nicht vorhanden sein. Wenn es im DPA nicht vorhanden ist, wird das neue Element an der Stelle eingefügt, an der pFind gewesen wäre, wenn es in sortierter Reihenfolge im DPA eingefügt worden wäre.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dpa_dsa.h

Share via