macro DPA_SortedInsertPtr (dpa_dsa.h)

Artigo
10/24/2024

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.

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

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

Observação Essa macro encapsula as funções DPA_InsertPtr e DPA_Search.

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

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

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	dpa_dsa.h

Compartilhar via