macro DPA_SortedInsertPtr (dpa_dsa.h)

Articolo
08/23/2023

Inserisce un nuovo elemento prima o dopo un elemento esistente specificato.

Sintassi

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

Parametri

hdpa

Tipo: HDPA

Handle per un DPA.

pFind

Tipo: void*

Puntatore all'elemento utilizzato per determinare il punto di inserimento per il nuovo elemento (vedere la sezione Osservazioni).

iStart

Tipo: int

Indice nel DPA in corrispondenza del quale iniziare la ricerca di pFind.

pfnCompare

Tipo: PFNDPACOMPARE

Puntatore alla funzione di confronto. Per il prototipo della funzione di confronto, vedere PFNDPACOMPARECONST o PFNDPACOMPARECONST .

lParam

Tipo: LPARAM

Parametro aggiuntivo usato per passare informazioni alla funzione di confronto a cui punta pfnCmp.

options

Tipo: UINT

Punto di inserimento. Deve essere uno dei valori seguenti.

Valore	Significato
DPAS_INSERTBEFORE	Inserire il nuovo elemento prima dell'elemento pFind .
DPAS_INSERTAFTER	Inserire il nuovo elemento dopo l'elemento pFind .

pitem

Tipo: void*

Puntatore all'elemento da inserire.

Valore restituito

nessuno

Osservazioni

Nota Questa macro esegue il wrapping delle funzioni DPA_InsertPtr e DPA_Search .

Il flag DPAS_SORTED è incluso nelle opzioni per impostazione predefinita per indicare che il DPA è ordinato.

Per altre informazioni su come si trova l'elemento pFind, vedere DPA_Search funzione. Il nuovo elemento viene inserito prima o dopo l'elemento pFind in base al parametro options . Il parametro pFind non deve esistere nel DPA. Se non esiste nel DPA, il nuovo elemento viene inserito dove pFind sarebbe stato inserito nel DPA in ordine ordinato.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dpa_dsa.h

Condividi tramite