PFNCALLBACK 回调函数 (ddeml.h)

与 动态数据交换管理库 一起使用的应用程序定义的回调函数 (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

返回值取决于事务类。 有关返回值的详细信息，请参阅各个事务类型的说明。

备注

XCLASS_BOOL

当 DDE 回调函数完成处理属于此类的事务时，它应返回 TRUE 或 FALSE 。 XCLASS_BOOL 事务类由以下类型组成：

• XTYP_ADVSTART
• XTYP_CONNECT

XCLASS_DATA

DDE 回调函数应在处理属于此类的事务时返回 DDE 句柄、 CBR_BLOCK 返回代码或 NULL 。 XCLASS_DATA 事务类由以下类型组成：

• XTYP_ADVREQ
• XTYP_REQUEST
• XTYP_WILDCONNECT

XCLASS_FLAGS

当 DDE 回调函数完成处理属于此类的事务时， 应返回DDE_FACK、 DDE_FBUSY或 DDE_FNOTPROCESSED 。 XCLASS_FLAGS 事务类由以下类型组成：

• XTYP_ADVDATA
• XTYP_EXECUTE
• XTYP_POKE

XCLASS_NOTIFICATION

属于此类的事务类型仅用于通知目的。 回调函数的返回值将被忽略。 XCLASS_NOTIFICATION 事务类由以下类型组成：

• XTYP_ADVSTOP
• XTYP_CONNECT_CONFIRM
• XTYP_DISCONNECT
• XTYP_ERROR
• XTYP_MONITOR
• XTYP_REGISTER
• XTYP_XACT_COMPLETE
• XTYP_UNREGISTER

回调函数是异步调用的，用于不涉及创建或终止会话的事务。 不经常接受传入消息的应用程序将降低 DDE 性能，因为动态数据交换管理库 (DDEML) 使用消息来启动事务。

应用程序必须在调用 DdeInitialize 函数时通过指定指向函数的指针来注册回调函数。

要求

最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	ddeml.h (包括 Windows.h)

请参阅

概念性

DdeEnableCallback

DdeInitialize

动态数据交换管理库