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 回调函数完成处理属于此类的事务时,应返回 TRUEFALSEXCLASS_BOOL事务类包含以下类型:

XCLASS_DATA

当 DDE 回调函数完成处理属于此类的事务时,应返回 DDE 句柄、 CBR_BLOCK 返回代码或 NULLXCLASS_DATA事务类包含以下类型:

XCLASS_FLAGS

当 DDE 回调函数完成处理属于此类的事务时,应返回 DDE_FACKDDE_FBUSYDDE_FNOTPROCESSEDXCLASS_FLAGS事务类包含以下类型:

XCLASS_NOTIFICATION

属于此类的事务类型仅用于通知目的。 将忽略回调函数的返回值。 XCLASS_NOTIFICATION事务类包含以下类型:

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

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

要求

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

另请参阅

概念性

DdeEnableCallback

DdeInitialize

动态数据交换管理库