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.

Valor	Significado
DPAS_INSERTBEFORE	Inserte el nuevo elemento antes del elemento de pFind.
DPAS_INSERTAFTER	Inserte el nuevo elemento después del elemento pFind.

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

Nota Esta macro encapsula las funciones DPA_InsertPtr y DPA_Search.

 

La marca DPAS_SORTED se incluye en opciones de forma predeterminada para indicar que el DPA está ordenado.

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

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	dpa_dsa.h