Функция обратного вызова PFNDPAMERGE (dpa_dsa.h)

  • Статья

Определяет прототип для функции слияния, используемой DPA_Merge.

Синтаксис

PFNDPAMERGE Pfndpamerge;

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

Параметры

[in] uMsg

Тип: UINT

Сообщение, которое указывает этой функции, как обработать слияние. Одно из следующих значений.

Значение Значение
DPAMM_MERGE
0x1
 Выполните дополнительную обработку, необходимую при слиянии pvSrc с pvDest. Функция должна возвращать указатель на элемент, содержащий результат слияния. Значение, возвращаемое функцией слияния, сохраняется в назначении, которое перезаписывает предыдущее значение. Если функция слияния возвращает значение NULL, операция слияния будет прекращена.
DPAMM_DELETE
0x2
 Выполните дополнительную обработку, необходимую при удалении в рамках слияния. Функция должна возвращать значение NULL.
DPAMM_INSERT
0x3
 Выполнение любой пользовательской обработки, когда слияние приводит к вставке элемента в составе слияния. Возвращаемое значение этой функции должно указывать на результат элемента, который вставляется при слиянии. Если функция слияния возвращает значение NULL, операция слияния будет прекращена.

[in] pvDest

Тип: void*

Указатель на первый элемент в слиянии.

[in] pvSrc

Тип: void*

Указатель на второй элемент в слиянии.

[in] lParam

Тип: LPARAM

Дополнительные данные, которые могут использоваться обратным вызовом слияния.

Возвращаемое значение

Указатель на элемент, полученный в результате слияния, или значение NULL , если при использовании DPAMM_MERGE или DPAMM_INSERT возникает сбой .

Комментарии

Функция обратного вызова может не изменять динамические массивы указателей (DPA), участвующие в операции слияния.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header dpa_dsa.h

См. также раздел

PFNDPAMERGECONST