macro DPA_SortedInsertPtr (dpa_dsa.h)

Insere um novo item antes ou depois de um item existente especificado.

Sintaxe

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

Parâmetros

hdpa

Tipo: HDPA

Um identificador para uma DPA.

pFind

Tipo: void*

Um ponteiro de item que é usado para determinar o ponto de inserção do novo item (consulte Comentários).

iStart

Tipo: int

O índice no DPA no qual começar a pesquisar pFind.

pfnCompare

Tipo: PFNDPACOMPARE

Um ponteiro para a função de comparação. Consulte PFNDPACOMPARE ou PFNDPACOMPARECONST para o protótipo da função de comparação.

lParam

Tipo: LPARAM

Um parâmetro adicional usado para passar informações para a função de comparação apontada por pfnCompare.

options

Tipo: UINT

O ponto de inserção. Deve ser um dos seguintes valores.

pitem

Tipo: void*

Um ponteiro para o item que deve ser inserido.

Valor de retorno

Tipo: int

Retorna o índice do novo item ou -1 se a ação de inserção falhar.

Observações

Consulte DPA_Search de função para obter informações adicionais sobre como o item de de pFind está localizado. O novo item é inserido antes ou depois do item pFind de acordo com as opções de parâmetro. O parâmetro pFind não precisa existir no DPA. Se ele não existir no DPA, o novo item será inserido onde pFind teria sido se tivesse sido inserido no DPA em ordem classificada.

Requisitos