macro DPA_SortedInsertPtr (dpa_dsa.h)

  • Article

Insère un nouvel élément avant ou après un élément existant spécifié.

Syntaxe

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

Paramètres

hdpa

Type : HDPA

Handle vers un DPA.

pFind

Type : void*

Pointeur d’élément utilisé pour déterminer le point d’insertion du nouvel élément (voir Remarques).

iStart

Type : int

Index dans le DPA auquel commencer la recherche de pFind.

pfnCompare

Type : PFNDPACOMPARE

Pointeur vers la fonction de comparaison. Consultez PFNDPACOMPARE ou PFNDPACOMPARECONST pour le prototype de fonction de comparaison.

lParam

Type : LPARAM

Paramètre supplémentaire utilisé pour transmettre des informations à la fonction de comparaison pointée par pfnCompare.

options

Type : UINT

Point d’insertion. Doit être l’une des valeurs suivantes.

Valeur Signification
DPAS_INSERTBEFORE
 Insérez le nouvel élément avant l’élément pFind.
DPAS_INSERTAFTER
 Insérez le nouvel élément après l’élément pFind.

pitem

Type : void*

Pointeur vers l’élément à insérer.

Valeur de retour

Type : int

Retourne l’index du nouvel élément ou -1 si l’action d’insertion échoue.

Remarques

Remarque Cette macro encapsule les fonctions DPA_InsertPtr et DPA_Search.
 
L’indicateur DPAS_SORTED est inclus dans options par défaut pour indiquer que le DPA est trié.

Consultez la DPA_Search de fonction pour plus d’informations sur la façon dont se trouve l’élément pFind . Le nouvel élément est inséré avant ou après l’élément pFind en fonction des options de paramètre. Le paramètre pFind n’a pas besoin d’exister dans le DPA. S’il n’existe pas dans la DPA, le nouvel élément est inséré où pFind aurait été inséré dans l’ordre trié.

Exigences

Exigence Valeur
client minimum pris en charge Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Windows
d’en-tête dpa_dsa.h