PFNDPAMERGE-Rückruffunktion (dpa_dsa.h)

Artikel
08/23/2023

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

Freigeben über