macro DPA_SortedInsertPtr (dpa_dsa.h)

Article
08/23/2023

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

Syntaxe

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

Paramètres

hdpa

Type : HDPA

Handle pour 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 la DPA à laquelle 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 pfnCmp.

options

Type : UINT

Point d’insertion. Il doit s’agir de 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

None

Notes

Note Cette macro encapsule les fonctions DPA_InsertPtr et DPA_Search .

L’indicateur DPAS_SORTED est inclus dans les options par défaut pour indiquer que la DPA est triée.

Pour plus d’informations sur la façon dont se trouve l’élément pFind , consultez la DPA_Search de fonction. Le nouvel élément est inséré avant ou après l’élément pFind en fonction du paramètre options . 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é à l’emplacement où pFind aurait été inséré s’il avait été inséré dans la DPA dans l’ordre trié.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dpa_dsa.h