macro DPA_SortedInsertPtr (dpa_dsa.h)

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

Sintassi

int DPA_SortedInsertPtr(
   HDPA          hdpa,
   void          *pFind,
   int           iStart,
   PFNDPACOMPARE pfnCompare,
   LPARAM        lParam,
   UINT          options,
   void          *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 Note).

iStart

Tipo: int

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

pfnCompare

Tipo: PFNDPACOMPARE

Puntatore alla funzione di confronto. Vedere PFNDPACOMPARE o PFNDPACOMPARECONST per il prototipo della funzione di confronto.

lParam

Tipo: LPARAM

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

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

Tipo: int

Restituisce l'indice del nuovo elemento o -1 se l'azione di inserimento ha esito negativo.

Osservazioni

Il flag DPAS_SORTED è incluso nelle opzioni di 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 opzioni. Il parametro pFind non deve esistere nel DPA. Se non esiste nel DPA, il nuovo elemento viene inserito in cui pFind sarebbe stato inserito nel DPA in ordine ordinato.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	dpa_dsa.h