Função de retorno de chamada PFNDPAMERGE (dpa_dsa.h)

Define o protótipo para a função de mesclagem usada por DPA_Merge.

Sintaxe

PFNDPAMERGE Pfndpamerge;

void * Pfndpamerge(
  [in] UINT uMsg,
  [in] void *pvDest,
  [in] void *pvSrc,
  [in] LPARAM lParam
)
{...}

[in] uMsg

Tipo: UINT

Uma mensagem que instrui essa função a lidar com a mesclagem. Um dos valores a seguir.

Valor	Significado
DPAMM_MERGE 0x1	Execute qualquer processamento adicional necessário ao mesclar pvSrc em pvDest. A função deve retornar um ponteiro para um item que contém o resultado da mesclagem. O valor retornado pela função de mesclagem é armazenado no destino, que substitui o valor anterior. Se a função de mesclagem retornar NULL, a operação de mesclagem será abandonada.
DPAMM_DELETE 0x2	Execute qualquer processamento adicional necessário quando uma exclusão ocorrer como parte da mesclagem. A função deve retornar NULL.
DPAMM_INSERT 0x3	Execute qualquer processamento definido pelo usuário quando a mesclagem resultar na inserção de um item como parte da mesclagem. O valor retornado dessa função deve apontar para o resultado do item que é inserido como parte da mesclagem. Se a função de mesclagem retornar NULL, a operação de mesclagem será abandonada.

[in] pvDest

Tipo: void*

Um ponteiro para o primeiro item na mesclagem.

[in] pvSrc

Tipo: void*

Um ponteiro para o segundo item na mesclagem.

[in] lParam

Tipo: LPARAM

Dados adicionais que podem ser usados pelo retorno de chamada de mesclagem.

Um ponteiro para o item que resulta da mesclagem ou NULL se houver uma falha quando DPAMM_MERGE ou DPAMM_INSERT for usado.

A função de retorno de chamada pode não modificar as DPAs (matrizes de ponteiro dinâmico) envolvidas na operação de mesclagem.

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