Freigeben über


PFNDPAMERGE-Rückruffunktion (dpa_dsa.h)

Definiert den Prototyp für die Mergefunktion, die von DPA_Merge verwendet wird.

Syntax

PFNDPAMERGE Pfndpamerge;

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

Parameter

[in] uMsg

Typ: UINT

Eine Meldung, die diese Funktion anweist, wie sie den Merge behandeln soll. Einer der folgenden Werte.

Wert Bedeutung
DPAMM_MERGE
0x1
Führen Sie alle zusätzlichen Verarbeitungen durch, die beim Zusammenführen von pvSrc in pvDest erforderlich sind. Die Funktion sollte einen Zeiger auf ein Element zurückgeben, das das Ergebnis der Zusammenführung enthält. Der von der Mergefunktion zurückgegebene Wert wird im Ziel gespeichert, wodurch der vorherige Wert überschrieben wird. Wenn die Mergefunktion NULL zurückgibt, wird der Mergevorgang abgebrochen.
DPAMM_DELETE
0x2
Führen Sie alle zusätzlichen Verarbeitungen aus, die beim Löschen im Rahmen der Zusammenführung erforderlich sind. Die Funktion sollte NULL zurückgeben.
DPAMM_INSERT
0x3
Führen Sie eine beliebige benutzerdefinierte Verarbeitung aus, wenn der Merge dazu führt, dass ein Element als Teil des Merges eingefügt wird. Der Rückgabewert dieser Funktion sollte auf das Elementergebnis verweisen, das als Teil der Zusammenführung eingefügt wird. Wenn die Mergefunktion NULL zurückgibt, wird der Mergevorgang abgebrochen.

[in] pvDest

Typ: void*

Ein Zeiger auf das erste Element im Merge.

[in] pvSrc

Typ: void*

Ein Zeiger auf das zweite Element im Merge.

[in] lParam

Typ: LPARAM

Zusätzliche Daten, die vom Mergerückruf verwendet werden können.

Rückgabewert

Ein Zeiger auf das Element, das sich aus dem Merge oder NULL ergibt, wenn bei verwendung DPAMM_MERGE oder DPAMM_INSERT ein Fehler auftritt.

Hinweise

Die Rückruffunktion ändert möglicherweise nicht die dynamischen Zeigerarrays (DPAs), die am Mergevorgang beteiligt sind.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dpa_dsa.h

Weitere Informationen

PFNDPAMERGECONST