DdeAddData 函数 (ddeml.h)

将数据添加到指定的动态数据交换 (DDE) 对象。 应用程序可以添加从对象开头的任何偏移量开始的数据。 如果新数据与对象中已有的数据重叠,则新数据将覆盖发生重叠的字节中的旧数据。 对象中尚未写入的位置的内容是不确定的。

语法

HDDEDATA DdeAddData(
  [in] HDDEDATA hData,
  [in] LPBYTE   pSrc,
  [in] DWORD    cb,
  [in] DWORD    cbOff
);

参数

[in] hData

类型: HDDEDATA

接收其他数据的 DDE 对象的句柄。

[in] pSrc

类型: LPBYTE

要添加到 DDE 对象中的数据。

[in] cb

类型:DWORD

要添加到 DDE 对象的数据的长度(以字节为单位),如果数据是字符串,则包括终止 NULL

[in] cbOff

类型:DWORD

从 DDE 对象开头的偏移量(以字节为单位)。 从此偏移量开始,将附加数据复制到对象。

返回值

类型: HDDEDATA

如果函数成功,则返回值是 DDE 对象的新句柄。 新句柄用于对象的所有引用中。

如果函数失败,则返回值为零。

DdeGetLastError 函数可用于获取错误代码,该错误代码可以是以下值之一:

注解

将数据句柄用作另一个 动态数据交换管理库 函数中的参数或由 DDE 回调函数返回后,该句柄只能用于对该句柄标识的 DDE 对象的读取访问。

如果最初分配的内存量小于保存添加的数据所需的内存量, DdeAddData 将重新分配适当大小的全局内存对象。

要求

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

请参阅

概念性

DdeAccessData

DdeCreateDataHandle

DdeUnaccessData

动态数据交换管理库

引用