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

Статья
08/23/2023

Определяемая приложением функция обратного вызова, используемая с функциями библиотеки DDEML . Он обрабатывает транзакции динамического обмена данными (DDE). Тип PFNCALLBACK определяет указатель на эту функцию обратного вызова. DdeCallback — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

Параметры

[in] wType

Тип: UINT

Тип текущей транзакции. Этот параметр состоит из сочетания флагов класса транзакций и флагов типов транзакций. В следующей таблице описаны все классы транзакций и приведен список типов транзакций в каждом классе. Сведения о конкретном типе транзакции см. в отдельном описании этого типа в разделе Примечания.

[in] wFmt

Тип: UINT

Формат отправки или получения данных.

[in] hConv

Тип: HCONV

Дескриптор диалога, связанного с текущей транзакцией.

[in] hsz1

Тип: HSZ

Дескриптор строки. Значение этого параметра зависит от типа текущей транзакции. Значение этого параметра см. в описании типа транзакции в разделе Примечания.

[in] hsz2

Тип: HSZ

[in] hData

Тип: HDDEDATA

Дескриптор данных DDE. Значение этого параметра зависит от типа текущей транзакции. Значение этого параметра см. в описании типа транзакции в разделе Примечания.

[in] dwData1

Тип: ULONG_PTR

Данные, относящиеся к транзакциям. Значение этого параметра см. в описании типа транзакции в разделе Примечания.

[in] dwData2

Тип: ULONG_PTR

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

Тип: HDDEDATA

Возвращаемое значение зависит от класса транзакции. Дополнительные сведения о возвращаемых значениях см. в описании отдельных типов транзакций.

Функция обратного вызова DDE должна возвращать значение TRUE или FALSE после завершения обработки транзакции, принадлежающей этому классу. Класс транзакций XCLASS_BOOL состоит из следующих типов:

XCLASS_DATA

Функция обратного вызова DDE должна возвращать дескриптор DDE, код возврата CBR_BLOCK или значение NULL после завершения обработки транзакции, принадлежающей этому классу. Класс транзакций XCLASS_DATA состоит из следующих типов:

XCLASS_FLAGS

Функция обратного вызова DDE должна возвращать DDE_FACK, DDE_FBUSY или DDE_FNOTPROCESSED после завершения обработки транзакции, которая принадлежит этому классу. Класс транзакций XCLASS_FLAGS состоит из следующих типов:

XCLASS_NOTIFICATION

Типы транзакций, принадлежащие этому классу, предназначены только для уведомлений. Возвращаемое значение функции обратного вызова игнорируется. Класс транзакций XCLASS_NOTIFICATION состоит из следующих типов:

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

Приложение должно зарегистрировать функцию обратного вызова, указав указатель на функцию в вызове функции DdeInitialize .

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ddeml.h (включая Windows.h)

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

Основные понятия

DdeEnableCallback

DdeInitialize

Библиотека управления Динамическим обменом данными

Поделиться через