macro DPA_SortedInsertPtr (dpa_dsa.h)

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

Sintaxe

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

Parâmetros

hdpa

Tipo: HDPA

Um identificador para um DPA.

pFind

Tipo: void*

Um ponteiro de item 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 ver 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 pfnCmp.

options

Tipo: UINT

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

Valor	Significado
DPAS_INSERTBEFORE	Insira o novo item antes do item pFind .
DPAS_INSERTAFTER	Insira o novo item após o item pFind .

pitem

Tipo: void*

Um ponteiro para o item que deve ser inserido.

Valor retornado

Nenhum

Comentários

Nota Essa macro encapsula as funções DPA_InsertPtr e DPA_Search .

 

O sinalizador DPAS_SORTED é incluído em opções por padrão para indicar que o DPA está classificado.

Consulte a função DPA_Search para obter informações adicionais sobre como o item pFind está localizado. O novo item é inserido antes ou depois do item pFind de acordo com o parâmetro de opções . 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

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	dpa_dsa.h