Funzione di callback PFNDPAMERGE (dpa_dsa.h)

Definisce il prototipo per la funzione di merge utilizzata da DPA_Merge.

Sintassi

PFNDPAMERGE Pfndpamerge;

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

[in] uMsg

Tipo: UINT

Messaggio che indica a questa funzione come gestire l'unione. Uno dei valori seguenti.

Valore	Significato
DPAMM_MERGE 0x1	Eseguire qualsiasi elaborazione aggiuntiva necessaria durante l'unione di pvSrc in pvDest. La funzione deve restituire un puntatore a un elemento contenente il risultato dell'unione. Il valore restituito dalla funzione di merge viene archiviato nella destinazione, che sovrascrive il valore precedente. Se la funzione di merge restituisce NULL, l'operazione di unione viene abbandonata.
DPAMM_DELETE 0x2	Eseguire qualsiasi elaborazione aggiuntiva necessaria quando si verifica un'eliminazione come parte dell'unione. La funzione deve restituire NULL.
DPAMM_INSERT 0x3	Eseguire qualsiasi elaborazione definita dall'utente quando il merge genera un elemento inserito come parte dell'unione. Il valore restituito di questa funzione deve puntare al risultato dell'elemento inserito come parte dell'unione. Se la funzione di merge restituisce NULL, l'operazione di unione viene abbandonata.

[in] pvDest

Tipo: void*

Puntatore al primo elemento dell'unione.

[in] pvSrc

Tipo: void*

Puntatore al secondo elemento nell'unione.

[in] lParam

Tipo: LPARAM

Dati aggiuntivi che possono essere usati dal callback di tipo merge.

Puntatore all'elemento che genera l'unione o NULL se si verifica un errore quando viene usato DPAMM_MERGE o DPAMM_INSERT .

La funzione di callback potrebbe non modificare le matrici del puntatore dinamico (DPA) coinvolte nell'operazione di merge.

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dpa_dsa.h