macro DPA_SortedInsertPtr (dpa_dsa.h)

Inserta un nuevo elemento antes o después de un elemento existente especificado.

Sintaxis

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

Parámetros

hdpa

Tipo: HDPA

Identificador de un DPA.

pFind

Tipo: void*

Puntero de elemento que se usa para determinar el punto de inserción del nuevo elemento (vea Comentarios).

iStart

Tipo: int

Índice del DPA en el que se va a empezar a buscar pFind.

pfnCompare

Tipo: PFNDPACOMPARE

Puntero a la función de comparación. Consulte PFNDPACOMPARE o PFNDPACOMPARECONST para el prototipo de función de comparación.

lParam

Tipo: LPARAM de

Parámetro adicional usado para pasar información a la función de comparación a la que apunta pfnCompare.

options

Tipo: UINT de

Punto de inserción. Debe ser uno de los siguientes valores.

pitem

Tipo: void*

Puntero al elemento que se va a insertar.

Valor devuelto

Tipo: int

Devuelve el índice del nuevo elemento o -1 si se produce un error en la acción de inserción.

Observaciones

Consulte DPA_Search de función para obtener información adicional sobre cómo se encuentra el elemento de pFind de . El nuevo elemento se inserta antes o después del elemento pFind según las opciones de parámetro. El parámetro pFind no debe existir en el DPA. Si no existe en el DPA, el nuevo elemento se inserta donde pFind habría sido insertado en el DPA en orden ordenado.

Requisitos